OpenWriterControle/.opencode/context/core/context-system/standards/frontmatter.md
Darren Hinde 1819b2516b
refactor: remove plugins from profiles and update opencoder agent (#122)
* refactor: remove plugins from profiles and update opencoder agent

- Remove plugin:notify, plugin:telegram-bot, and plugin:telegram-notify from Business, Full, and Advanced profiles
- Update opencoder agent to use ContextScout for discovery instead of 'DIGGING IN...' phrase
- Reduces profile component count and improves agent context discovery workflow

* feat: implement function-based context system with wildcard dependencies

## Context System Overhaul

### New Context Standards (3 files)
- Add frontmatter.md: HTML comment frontmatter format for all context files
- Add codebase-references.md: Standards for linking context to code implementation
- Update templates.md: Add frontmatter and codebase references to all 5 templates

### System Builder Updates
- Replace topic-based folders (domain/processes/standards/templates) with function-based folders (concepts/examples/guides/lookup/errors)
- Add navigation.md as REQUIRED file in all context structures
- Update validation rules: 4 → 8 checks (frontmatter, codebase refs, MVI limits)
- Update file size limits to match MVI principle per folder type
- Update architecture planning, context organization, and delivery stages

### Context Organizer Refactor
- Replace 27 individual dependencies with 1 wildcard: context:core/context-system/*
- Implement 9-step standards-based workflow with code discovery
- Add Step 0: Load standards via @ symbol
- Add Step 1: Discover codebase using glob patterns
- Update all generation steps to use templates with frontmatter + codebase refs
- Add comprehensive validation (frontmatter, codebase refs, MVI, file size)

### Registry Updates
- Add 2 new context entries: frontmatter, codebase-references
- Update context-organizer dependencies: 11 individual IDs → 1 wildcard pattern
- Simplify maintenance: auto-includes new context-system files

### Benefits
- Simpler maintenance: 27 lines → 2 lines in agent dependencies
- Better organization: Function-based structure (what/how/reference/troubleshooting)
- Auto-scaling: New context-system files automatically included
- Standards enforcement: Frontmatter and codebase references required
- Complete coverage: All context-system files discoverable via wildcard

### Other Changes
- Update ContextScout permissions and documentation
- Add visual-development.md context file
- Update design-iteration workflow
- Remove deprecated WORKFLOW_GUIDE.md
- Update README.md and developer profile

Co-authored-by: System Builder <system@openagents.dev>

* fix: add wildcard support to registry validation script

- Handle wildcard patterns in context dependencies (e.g., context:core/context-system/*)
- Extract prefix before wildcard and match against context file paths
- Prevents validation failures for wildcard dependencies in registry

---------

Co-authored-by: System Builder <system@openagents.dev>
2026-01-27 22:49:24 +00:00

1.6 KiB

Frontmatter Format

Purpose: HTML comment frontmatter format for all context files

Last Updated: 2026-01-27


Format

ALL context files MUST start with:
<!-- Context: {category}/{function} | Priority: {level} | Version: X.Y | Updated: YYYY-MM-DD -->

Components

Category/Function: {category}/{function}

  • Examples: ecommerce/concepts, development/examples, core/standards
  • Category = domain (ecommerce, payments, development)
  • Function = file type (concepts, examples, guides, lookup, errors)

Priority: critical | high | medium | low

  • critical: 80% of use cases (business logic, core concepts)
  • high: 15% of use cases (common workflows, examples)
  • medium: 4% of use cases (edge cases)
  • low: 1% of use cases (rare scenarios)

Version: X.Y (start 1.0, increment on changes)

Updated: YYYY-MM-DD (ISO 8601, must match metadata section)


Examples

<!-- Context: ecommerce/concepts | Priority: critical | Version: 1.0 | Updated: 2026-01-27 -->
<!-- Context: payments/guides | Priority: high | Version: 1.2 | Updated: 2026-01-27 -->
<!-- Context: development/examples | Priority: medium | Version: 1.0 | Updated: 2026-01-27 -->

Validation

  • Frontmatter is first line?
  • Format exact: <!-- Context: ... -->?
  • Priority is critical|high|medium|low?
  • Version is X.Y?
  • Date is YYYY-MM-DD?

  • structure.md - File organization
  • templates.md - File templates
  • codebase-references.md - Linking to code