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

* 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

2026-01-13 11:25:18 +00:00

2.5 KiB

Raw Blame History

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:

Start with navigation.md (this file)
Read all files in order for complete understanding
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.

2.5 KiB Raw Blame History