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
3.4 KiB
3.4 KiB
Business ↔ Tech Bridge
Document how business needs translate to technical solutions. This is the critical connection point.
Quick Reference
- Purpose: Show stakeholders technical choices serve business goals
- Purpose: Show developers business constraints drive architecture
- Update When: New features, refactoring, business pivot
Core Mapping
| Business Need | Technical Solution | Why This Mapping | Business Value |
|---|---|---|---|
| [Users need X] | [Technical implementation] | [Why this maps] | [Value delivered] |
| [Business wants Y] | [Technical implementation] | [Why this maps] | [Value delivered] |
| [Compliance requires Z] | [Technical implementation] | [Why this maps] | [Value delivered] |
Feature Mapping Examples
Feature: [Feature Name]
Business Context:
- User need: [What users need]
- Business goal: [Why this matters to business]
- Priority: [Why this was prioritized]
Technical Implementation:
- Solution: [What was built]
- Architecture: [How it fits the system]
- Trade-offs: [What was considered and why it won]
Connection: [Explain clearly how the technical solution serves the business need. What would happen without this feature? What does this feature enable for the business?]
Feature: [Feature Name]
Business Context:
- User need: [What users need]
- Business goal: [Why this matters to business]
- Priority: [Why this was prioritized]
Technical Implementation:
- Solution: [What was built]
- Architecture: [How it fits the system]
- Trade-offs: [What was considered and why it won]
Connection: [Explain clearly how the technical solution serves the business need.]
Trade-off Decisions
When business and technical needs conflict, document the trade-off:
| Situation | Business Priority | Technical Priority | Decision Made | Rationale |
|---|---|---|---|---|
| [Conflict] | [What business wants] | [What tech wants] | [What was chosen] | [Why this was right] |
Common Misalignments
| Misalignment | Warning Signs | Resolution Approach |
|---|---|---|
| [Type of mismatch] | [Symptoms to watch for] | [How to address] |
Stakeholder Communication
This file helps translate between worlds:
For Business Stakeholders:
- Shows that technical investments serve business goals
- Provides context for why certain choices were made
- Demonstrates ROI of technical decisions
For Technical Stakeholders:
- Provides business context for architectural decisions
- Shows the "why" behind constraints and requirements
- Helps prioritize technical debt with business impact
Onboarding Checklist
- Understand the core business needs this project addresses
- See how each major feature maps to business value
- Know the key trade-offs and why decisions were made
- Be able to explain to stakeholders why technical choices matter
- Be able to explain to developers why business constraints exist
Related Files
business-domain.md- Business needs in detailtechnical-domain.md- Technical implementation in detaildecisions-log.md- Decisions made with full contextliving-notes.md- Current open questions and issues