Project Context
Every project has a CONTEXT.md that tracks its state across three time horizons.
When to Use
- •Starting a new project
- •Resuming work on a project
- •Updating project status
- •Planning next steps
Location
code
Second Brain/Projects/{project-name}/CONTEXT.md
Structure
Past (How We Got Here)
- •Origin: Why this project exists
- •Key Decisions: What was decided and why
- •Lessons: What we learned
Current (Where We Are)
- •Status: One sentence state
- •Tasks: Active work items
- •Blockers: What's in the way
Future (Where We're Going)
- •Next Milestone: Concrete deliverable
- •End Goal: What done looks like
- •Open Questions: Unresolved decisions
Procedure
At Session Start
- •Read the project's CONTEXT.md
- •Focus on Current section
- •Note any blockers
During Work
Update as state changes:
- •Complete a task → update Tasks
- •Hit a blocker → add to Blockers
- •Make a decision → add to Key Decisions
At Session End
- •Update Current section
- •Move completed work to Past if significant
- •Adjust Future if plans changed
Template
See template.md for the full template.