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

3.4 KiB

Raw Blame History

Living Notes

Active issues, technical debt, open questions, and insights that don't fit elsewhere. Keep this alive.

Quick Reference

Purpose: Capture current state, problems, and open questions
Update: Weekly or when status changes
Archive: Move resolved items to bottom with status

Technical Debt

Item	Impact	Priority	Mitigation
[Debt item]	[What risk it creates]	[High/Med/Low]	[How to manage]

Technical Debt Details

[Debt Item]
Priority: [High/Med/Low]
Impact: [What happens if not addressed]
Root Cause: [Why this debt exists]
Proposed Solution: [How to fix it]
Effort: [Small/Medium/Large]
Status: [Acknowledged | Scheduled | In Progress | Deferred]

Open Questions

Question	Stakeholders	Status	Next Action
[Question]	[Who needs to decide]	[Open/In Progress]	[What needs to happen]

Open Question Details

[Question]
Context: [Why this question matters]
Stakeholders: [Who needs to be involved]
Options: [What are the possibilities]
Timeline: [When does this need resolution]
Status: [Open/In Progress/Blocked]

Known Issues

Issue	Severity	Workaround	Status
[Issue]	[Critical/High/Med/Low]	[Temporary fix]	[Known/In Progress/Fixed]

Issue Details

[Issue Title]
Severity: [Critical/High/Med/Low]
Impact: [Who/what is affected]
Reproduction: [Steps to reproduce if applicable]
Workaround: [Temporary solution if exists]
Root Cause: [If known]
Fix Plan: [How to properly fix]
Status: [Known/In Progress/Fixed in vX.X]

Insights & Lessons Learned

What Works Well

[Positive pattern 1] - [Why it works]
[Positive pattern 2] - [Why it works]

What Could Be Better

[Area for improvement 1] - [Why it's a problem]
[Area for improvement 2] - [Why it's a problem]

Lessons Learned

[Lesson 1] - [Context and implication]
[Lesson 2] - [Context and implication]

Patterns & Conventions

Code Patterns Worth Preserving

[Pattern 1] - [Where it lives, why it's good]
[Pattern 2] - [Where it lives, why it's good]

Gotchas for Maintainers

[Gotcha 1] - [What to watch out for]
[Gotcha 2] - [What to watch out for]

Active Projects

Project	Goal	Owner	Timeline
[Project]	[What we're doing]	[Who owns it]	[When it matters]

Archive (Resolved Items)

Moved here for historical reference. Current team should refer to current notes above.

Resolved: [Item]

Resolved: [Date]
Resolution: [What was decided/done]
Learnings: [What we learned from this]

Onboarding Checklist

Review known technical debt and understand impact
Know what open questions exist and who's involved
Understand current issues and workarounds
Be aware of patterns and gotchas
Know active projects and timelines
Understand the team's priorities

decisions-log.md - Past decisions that inform current state
business-domain.md - Business context for current priorities
technical-domain.md - Technical context for current state
business-tech-bridge.md - Context for current trade-offs

3.4 KiB Raw Blame History