feat: Organize context files and enhance documentation for clarity and structure
This commit is contained in:
@@ -19,7 +19,10 @@ Behavior rules:
|
||||
- daily facts go to `ai/logs/YYYY-MM-DD.md`
|
||||
- current priorities go to `ai/state/current.md`
|
||||
- active Jira-linked work goes to `ai/state/work-items.md`
|
||||
- durable project knowledge goes to `ai/context/project.md`
|
||||
- durable project knowledge overview goes to `ai/context/project.md`
|
||||
- system-specific durable knowledge goes to `ai/context/systems/`
|
||||
- workstream-specific durable knowledge goes to `ai/context/workstreams/`
|
||||
- process-specific durable knowledge goes to `ai/context/process/`
|
||||
- confirmed team or manager communication preferences go to `ai/context/people/manager.md`
|
||||
- role-to-person mapping and recurring stakeholders go to `ai/context/people/`
|
||||
- confirmed decisions go to `ai/context/decisions/`
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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:
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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:
|
||||
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -14,7 +14,11 @@ export const FidelityCompaction = async ({ directory }) => {
|
||||
"experimental.session.compacting": async (_input, output) => {
|
||||
const baseFiles = [
|
||||
"README.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/people/manager.md",
|
||||
"ai/context/people/index.md",
|
||||
"ai/state/current.md",
|
||||
|
||||
Reference in New Issue
Block a user