fix(context): Add frontmatter to context files with missing metadata (#97 )

* feat(context): Add project intelligence system

- Add project-intelligence.md standard (what & why)
- Add project-intelligence-management.md guide (how to manage)
- Add project-intelligence/ folder with 6 context files:
  - navigation.md (quick overview & routes)
  - business-domain.md (business context, users, value)
  - technical-domain.md (stack, architecture, decisions)
  - business-tech-bridge.md (business → technical mapping)
  - decisions-log.md (decision history with context)
  - living-notes.md (active issues, debt, questions)
- Update standards navigation with new entries
- Register all new contexts in registry.json

This enables projects to document and maintain business + technical
context for quick onboarding and lasting project understanding.

* fix(registry): Add project-intelligence to profiles

- Add context:project-intelligence/* to developer, business, full, and advanced profiles
- Ensures project intelligence contexts are included when these profiles are selected

This complements commit c731328 which added the context entries.

* docs(core): refine project intelligence system and deprecate legacy context

* feat(claude): simplify Claude Code integration with unified installer

- Create single install-claude.sh script that auto-converts and installs
- Remove redundant bootstrap-install.sh and install.sh scripts
- Delete stale plugin/ directory (now auto-generated from .opencode/)
- Add Claude Code documentation (agent-skills, create-subagents, hooks, plugins)
- Add installation profiles (essential, developer, business, full, advanced)
- Update README with Claude Code beta feature documentation
- Add component-planning.md workflow context
- Clean up demo files (assets/, src/)
- Update registry with new context entries
- Add gitignore rule for converter/generated/

The new installer:
- Converts agents automatically from .opencode/agent/
- Installs fresh converted agents to ~/.claude/plugins/
- Single command: ./integrations/claude-code/install-claude.sh

* fix: update README to use new install-claude.sh script

The Claude Code integration now uses the unified install-claude.sh script
instead of the removed bootstrap-install.sh and install.sh scripts.

* fix(context): Add frontmatter to context files with missing metadata

- Add YAML frontmatter with description to system-builder-templates
- Add frontmatter to ui/web/design context files
- Fixes validation warnings in validate-component.sh

* fix(registry): Remove orphaned context entries for deleted files

- Remove copywriting-frameworks entry (file moved to content-creation/principles/)
- Remove tone-voice entry (file moved to content-creation/principles/)

2026-01-17 21:29:48 +00:00

4 KiB

Raw Blame History

OpenAgents Repository Context

Purpose: Context files specific to the OpenAgents repository

Last Updated: 2026-01-13

Function	Files	Purpose
Concepts	2 files	Core ideas and principles
Examples	1 file	Working code samples
Guides	8 files	Step-by-step workflows
Lookup	4 files	Quick reference tables
Errors	1 file	Common issues + solutions

Concepts (Core Ideas)

File	Topic	Priority
`concepts/subagent-testing-modes.md`	Standalone vs delegation testing	⭐⭐⭐⭐⭐

When to read: Before testing any subagent

Examples (Working Code)

File	Topic	Priority
`examples/subagent-prompt-structure.md`	Optimized subagent prompt template	⭐⭐⭐⭐

When to read: When creating or optimizing subagent prompts

Guides (Step-by-Step)

File	Topic	Priority
`guides/testing-subagents.md`	How to test subagents standalone	⭐⭐⭐⭐⭐
`guides/adding-agent.md`	How to add new agents	⭐⭐⭐⭐
`guides/testing-agent.md`	How to test agents	⭐⭐⭐⭐
`guides/updating-registry.md`	How to update registry	⭐⭐⭐
`guides/debugging.md`	How to debug issues	⭐⭐⭐
`guides/resolving-installer-wildcard-failures.md`	Fix wildcard context install failures	⭐⭐⭐
`guides/creating-release.md`	How to create releases	⭐⭐

When to read: When performing specific tasks

Lookup (Quick Reference)

File	Topic	Priority
`lookup/subagent-test-commands.md`	Subagent testing commands	⭐⭐⭐⭐⭐
`lookup/file-locations.md`	Where files are located	⭐⭐⭐⭐
`lookup/commands.md`	Available slash commands	⭐⭐⭐

When to read: Quick command lookups

Errors (Troubleshooting)

File	Topic	Priority
`errors/tool-permission-errors.md`	Tool permission issues	⭐⭐⭐⭐⭐

When to read: When tests fail with permission errors

Core Concepts (Foundational)

File	Topic	Priority
`core-concepts/agents.md`	How agents work	⭐⭐⭐⭐⭐
`core-concepts/evals.md`	How testing works	⭐⭐⭐⭐⭐
`core-concepts/registry.md`	How registry works	⭐⭐⭐⭐
`core-concepts/categories.md`	How organization works	⭐⭐⭐

When to read: First time working in this repo

Loading Strategy

For Subagent Testing:

Load concepts/subagent-testing-modes.md (understand modes)
Load guides/testing-subagents.md (step-by-step)
Reference lookup/subagent-test-commands.md (commands)
If errors: Load errors/tool-permission-errors.md

For Agent Creation:

Load core-concepts/agents.md (understand structure)
Load guides/adding-agent.md (step-by-step)
Load examples/subagent-prompt-structure.md (if subagent)
Load guides/testing-agent.md (validate)

For Debugging:

Load guides/debugging.md (general approach)
Load specific error file from errors/
Reference lookup/file-locations.md (find files)

File Size Compliance

All files follow MVI principle (<200 lines):

✅ Concepts: <100 lines
✅ Examples: <100 lines
✅ Guides: <150 lines
✅ Lookup: <100 lines
✅ Errors: <150 lines

../core/ - Core system context (standards, patterns)
../core/context-system/ - Context management system
quick-start.md - 2-minute repo orientation
../content-creation/navigation.md - Content creation principles
../to-be-consumed/claude-code-docs/plugins.md - Claude Code extension docs

Contributing

When adding new context files:

Follow MVI principle (<200 lines)
Use function-based organization (concepts/, examples/, guides/, lookup/, errors/)
Update this README.md navigation
Add cross-references to related files
Validate with /context validate

4 KiB Raw Blame History