feat: Update behavior rules and documentation for workspace maintenance and flow references

This commit is contained in:
2026-04-16 07:50:07 -06:00
parent a375b3c3b1
commit 1f57597ca3
21 changed files with 146 additions and 15 deletions

View File

@@ -15,6 +15,7 @@ Use these files as the baseline context:
@ai/context/ios/project-swift-guidance.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/workstreams/flow-page-references.md
@ai/context/process/communication.md
@ai/context/process/ai-to-ai-prompting.md
@ai/context/process/jira-story-rules.md

View File

@@ -11,6 +11,7 @@ Read:
@ai/context/project.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/workstreams/flow-page-references.md
@ai/context/process/index.md
@ai/work-items/index.md
@ai/state/current.md
@@ -49,8 +50,14 @@ Instructions:
- `ai/context/workstreams/*.md`
- `ai/context/process/*.md`
- `ai/context/decisions/*.md`
- `.opencode/commands/*.md` when command behavior needs to change
- `prompts/*.md` when a reusable output template needs to change
- `.opencode/agents/*.md` or `ai/AGENTS.md` when default agent behavior needs to change
- `.opencode/skills/*/SKILL.md` when a specialized workflow needs to change
- `knowledge/*.md` when a durable workspace rule needs to change
- Prefer concrete project updates over broad summaries
- If a fact is still ambiguous, do not promote it
- If the promoted fact is a reusable behavior correction, do not leave it only in a daily log; update the operational file that controls future behavior
- Use this command when you want a deliberate manual pass beyond the agent's default automatic memory maintenance
Return:

View File

@@ -15,6 +15,7 @@ Read:
@ai/context/index.md
@ai/context/project.md
@ai/context/workstreams/index.md
@ai/context/workstreams/flow-page-references.md
@ai/context/process/communication.md
@ai/context/process/jira-story-rules.md
@ai/context/people/manager.md
@@ -49,6 +50,8 @@ Before drafting:
- prioritize story-based updates over side questions, memory refreshes, or manager-only context
- if documentation or root cause updates directly support a story, roll them into that story's update instead of listing them separately
- exclude items that are not directly tied to a story unless they are true blockers
- when one Jira item has multiple concrete updates, group them under one top-level `JIRA-ID - Title` bullet with indented markdown sub-bullets instead of repeating the same Jira line
- use `ai/context/workstreams/flow-page-references.md` to preserve real flow/page identifiers when shorthand appears in logs or messages
Return a standup that is:
@@ -61,4 +64,5 @@ Return a standup that is:
- free of any mention of Jeff by name
- free of any mention of Mattermost, since it is internal-only communication
- uses bullet points for each item
- groups multiple updates for the same Jira item as indented sub-bullets
- uses `JIRA-ID - Title` or `JIRA-ID Title` formatting instead of comma-separated ID/title formatting

View File

@@ -12,6 +12,7 @@ Read:
@ai/context/project.md
@ai/context/systems/index.md
@ai/context/workstreams/index.md
@ai/context/workstreams/flow-page-references.md
@ai/context/process/context-maintenance.md
@ai/context/people/manager.md
@ai/context/people/index.md
@@ -46,8 +47,14 @@ Instructions:
- `ai/context/people/index.md`
- `ai/context/people/*.md`
- `ai/context/decisions/`
- `.opencode/commands/*.md`
- `prompts/*.md`
- `.opencode/agents/*.md`
- `.opencode/skills/*/SKILL.md`
- `knowledge/*.md`
- Update the appropriate files directly
- If an existing statement became stale, replace or refine it
- If the new information changes how this workspace should behave, update the linked command, prompt, agent, skill, or knowledge file that enforces that behavior
- Do not invent missing facts
- Keep uncertain information in the daily log instead of promoting it to stable context
- Do not ask for promotion confirmation when the correct destination is already clear