9a58a03284
* 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/)
143 lines
4 KiB
Markdown
143 lines
4 KiB
Markdown
# OpenAgents Repository Context
|
|
|
|
**Purpose**: Context files specific to the OpenAgents repository
|
|
|
|
**Last Updated**: 2026-01-13
|
|
|
|
---
|
|
|
|
## Quick Navigation
|
|
|
|
| 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:
|
|
1. Load `concepts/subagent-testing-modes.md` (understand modes)
|
|
2. Load `guides/testing-subagents.md` (step-by-step)
|
|
3. Reference `lookup/subagent-test-commands.md` (commands)
|
|
4. If errors: Load `errors/tool-permission-errors.md`
|
|
|
|
### For Agent Creation:
|
|
1. Load `core-concepts/agents.md` (understand structure)
|
|
2. Load `guides/adding-agent.md` (step-by-step)
|
|
3. Load `examples/subagent-prompt-structure.md` (if subagent)
|
|
4. Load `guides/testing-agent.md` (validate)
|
|
|
|
### For Debugging:
|
|
1. Load `guides/debugging.md` (general approach)
|
|
2. Load specific error file from `errors/`
|
|
3. 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
|
|
|
|
---
|
|
|
|
## Related Context
|
|
|
|
- `../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:
|
|
|
|
1. Follow MVI principle (<200 lines)
|
|
2. Use function-based organization (concepts/, examples/, guides/, lookup/, errors/)
|
|
3. Update this README.md navigation
|
|
4. Add cross-references to related files
|
|
5. Validate with `/context validate`
|