feat: Organize context files and enhance documentation for clarity and structure
This commit is contained in:
33
ai/context/process/context-maintenance.md
Normal file
33
ai/context/process/context-maintenance.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# Context Maintenance
|
||||
|
||||
## Goal
|
||||
|
||||
Keep this workspace useful as living memory instead of a pile of disconnected notes.
|
||||
|
||||
---
|
||||
|
||||
## Stable Rules
|
||||
|
||||
- Update canonical context when a durable fact changes.
|
||||
- Prefer correcting stale context over appending contradictory notes.
|
||||
- Use the smallest correct destination:
|
||||
- `ai/logs/YYYY-MM-DD.md` for daily progress and evolving findings
|
||||
- `ai/state/current.md` for near-term active work
|
||||
- `ai/state/work-items.md` for Jira-linked active work
|
||||
- `ai/context/` for durable project knowledge
|
||||
- `ai/context/people/` for named person context
|
||||
|
||||
---
|
||||
|
||||
## Ingestion Rules
|
||||
|
||||
- Treat Mattermost, Slack history, and direct prompts as potential memory sources.
|
||||
- Do not promote failed syncs or tooling errors as project facts.
|
||||
- Promote repeated durable patterns from historical archives into stable context when confidence is high.
|
||||
- Keep old status-only details archive-only unless they still change current understanding.
|
||||
|
||||
---
|
||||
|
||||
## Curation Rule
|
||||
|
||||
- If a new stable context file is added, keep `project.md` and `index.md` aligned so future sessions can discover it quickly.
|
||||
Reference in New Issue
Block a user