7590a7a2ff
* 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
65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
<!-- Context: project-intelligence/nav | Priority: high | Version: 1.0 | Updated: 2025-01-12 -->
|
|
|
|
# Project Intelligence
|
|
|
|
> Start here for quick project understanding. These files bridge business and technical domains.
|
|
|
|
## Structure
|
|
|
|
```
|
|
.opencode/context/project-intelligence/
|
|
├── navigation.md # This file - quick overview
|
|
├── business-domain.md # Business context and problem statement
|
|
├── technical-domain.md # Stack, architecture, technical decisions
|
|
├── business-tech-bridge.md # How business needs map to solutions
|
|
├── decisions-log.md # Major decisions with rationale
|
|
└── living-notes.md # Active issues, debt, open questions
|
|
```
|
|
|
|
## Quick Routes
|
|
|
|
| What You Need | File | Description |
|
|
|---------------|------|-------------|
|
|
| Understand the "why" | `business-domain.md` | Problem, users, value proposition |
|
|
| Understand the "how" | `technical-domain.md` | Stack, architecture, integrations |
|
|
| See the connection | `business-tech-bridge.md` | Business → technical mapping |
|
|
| Know the context | `decisions-log.md` | Why decisions were made |
|
|
| Current state | `living-notes.md` | Active issues and open questions |
|
|
| All of the above | Read all files in order | Full project intelligence |
|
|
|
|
## Usage
|
|
|
|
**New Team Member / Agent**:
|
|
1. Start with `navigation.md` (this file)
|
|
2. Read all files in order for complete understanding
|
|
3. Follow onboarding checklist in each file
|
|
|
|
**Quick Reference**:
|
|
- Business focus → `business-domain.md`
|
|
- Technical focus → `technical-domain.md`
|
|
- Decision context → `decisions-log.md`
|
|
|
|
## Integration
|
|
|
|
This folder is referenced from:
|
|
- `.opencode/context/core/standards/project-intelligence.md` (standards and patterns)
|
|
- `.opencode/context/core/system/context-guide.md` (context loading)
|
|
|
|
See `.opencode/context/core/context-system.md` for the broader context architecture.
|
|
|
|
## Maintenance
|
|
|
|
Keep this folder current:
|
|
- Update when business direction changes
|
|
- Document decisions as they're made
|
|
- Review `living-notes.md` regularly
|
|
- Archive resolved items from decisions-log.md
|
|
|
|
**Management Guide**: See `.opencode/context/core/standards/project-intelligence-management.md` for complete lifecycle management including:
|
|
- How to update, add, and remove files
|
|
- How to create new subfolders
|
|
- Version tracking and frontmatter standards
|
|
- Quality checklists and anti-patterns
|
|
- Governance and ownership
|
|
|
|
See `.opencode/context/core/standards/project-intelligence.md` for the standard itself.
|