feat: Organize context files and enhance documentation for clarity and structure

This commit is contained in:
2026-04-10 08:57:00 -06:00
parent 26f54ed302
commit ae9e69bd4b
38 changed files with 620 additions and 71 deletions

View File

@@ -8,7 +8,12 @@ Use these files as the baseline context:
@README.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/process/communication.md
@ai/context/process/jira-story-rules.md
@ai/context/people/manager.md
@ai/context/people/index.md
@ai/state/current.md

View File

@@ -8,7 +8,10 @@ Read:
@README.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/workstreams/index.md
@ai/context/process/context-maintenance.md
@ai/state/current.md
@ai/state/work-items.md
@knowledge/agent-memory-rules.md
@@ -30,6 +33,7 @@ Instructions:
- Keep the log concise but reusable for later standups and manager updates
- If the notes are ambiguous, normalize them without inventing facts
- If a note clearly corrects or sharpens existing current memory, update the corresponding canonical file as well
- If a note reveals durable system, workstream, process, or people context, update the relevant canonical file instead of only appending to the log
- Prefer `sync-context` for broader memory updates; use this command for fast daily capture
After editing, respond with:

View File

@@ -8,9 +8,11 @@ Read:
@prompts/manager-update.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/workstreams/index.md
@ai/context/process/communication.md
@ai/context/people/manager.md
@ai/context/people/jeff-dewitte.md
@ai/context/people/index.md
@ai/state/current.md
@ai/state/work-items.md

View File

@@ -7,7 +7,11 @@ Use this only when you want an explicit manual promotion pass.
Read:
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/process/index.md
@ai/state/current.md
@ai/state/work-items.md
@knowledge/workspace-model.md
@@ -39,6 +43,9 @@ Instructions:
- `ai/state/current.md`
- `ai/state/work-items.md`
- `ai/context/project.md`
- `ai/context/systems/*.md`
- `ai/context/workstreams/*.md`
- `ai/context/process/*.md`
- `ai/context/decisions/*.md`
- Prefer concrete project updates over broad summaries
- If a fact is still ambiguous, do not promote it

View File

@@ -23,7 +23,11 @@ First, run the importer:
Read:
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/process/index.md
@ai/context/people/index.md
@ai/context/people/manager.md
@ai/state/current.md

View File

@@ -12,9 +12,12 @@ Read:
@prompts/standup.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/workstreams/index.md
@ai/context/process/communication.md
@ai/context/process/jira-story-rules.md
@ai/context/people/manager.md
@ai/context/people/jeff-dewitte.md
@ai/state/current.md
@ai/state/work-items.md
@knowledge/communication-rules.md

View File

@@ -10,7 +10,7 @@ This command should optimize for:
- explicit scope
- useful acceptance criteria
- clear ownership framing
- natural US English that Jeff can reuse or forward without rewriting
- natural US English that the current manager or stakeholder can reuse or forward without rewriting
Input notes or rough idea:
@@ -20,9 +20,12 @@ Read:
@prompts/story-draft.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/workstreams/index.md
@ai/context/process/communication.md
@ai/context/process/jira-story-rules.md
@ai/context/people/manager.md
@ai/context/people/jeff-dewitte.md
@ai/context/people/index.md
@ai/state/current.md
@ai/state/work-items.md
@@ -50,6 +53,7 @@ Requirements:
- Acceptance criteria should be testable and scoped to the proposed story
- If the story looks too large or too ambiguous, say so explicitly and suggest spike framing instead
- If useful, include a short note about dependencies, blockers, or coordination needed
- If the story touches consumer validation or release propagation, reflect that explicitly in the description or notes
Return:

View File

@@ -8,7 +8,11 @@ Read:
@README.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/process/context-maintenance.md
@ai/context/people/manager.md
@ai/context/people/index.md
@ai/state/current.md
@@ -33,6 +37,9 @@ Instructions:
- `ai/state/current.md`
- `ai/state/work-items.md`
- `ai/context/project.md`
- `ai/context/systems/`
- `ai/context/workstreams/`
- `ai/context/process/`
- `ai/context/people/manager.md`
- `ai/context/people/index.md`
- `ai/context/people/*.md`

View File

@@ -15,7 +15,9 @@ Read:
@prompts/mattermost-translation.md
@ai/AGENTS.md
@ai/context/index.md
@ai/context/project.md
@ai/context/process/communication.md
@ai/context/people/manager.md
@ai/context/people/index.md
@knowledge/communication-rules.md