feat: Refactor work item management and documentation for clarity and structure

.opencode/commands/fidelity-context.md

@@ -16,6 +16,7 @@ Use these files as the baseline context:
 @ai/context/process/jira-story-rules.md
 @ai/context/people/manager.md
 @ai/context/people/index.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @ai/context/decisions/rest-vs-graphql.md
@@ -37,6 +38,10 @@ Recent logs available:
 
 !`ls -1 ai/logs 2>/dev/null | sort | tail -n 5`
 
+Detailed active work item files, if available:
+
+!`if [ -d ai/work-items ]; then for f in ai/work-items/*.md; do case "$f" in *README.md|*index.md) continue;; esac; echo "\n### $f"; cat "$f"; done; else echo "No work item files available."; fi`
+
 Latest Mattermost context, if available:
 
 !`if [ -s ai/inbox/mattermost-latest.md ]; then cat ai/inbox/mattermost-latest.md; elif [ -s scripts/mattermost/generated/mattermost_context.jsonl ]; then cat scripts/mattermost/generated/mattermost_context.jsonl; else echo "No Mattermost context available."; fi`

.opencode/commands/log-note.md

@@ -12,6 +12,7 @@ Read:
 @ai/context/project.md
 @ai/context/workstreams/index.md
 @ai/context/process/context-maintenance.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/agent-memory-rules.md

.opencode/commands/manager-update.md

@@ -14,6 +14,7 @@ Read:
 @ai/context/process/communication.md
 @ai/context/people/manager.md
 @ai/context/people/index.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/communication-rules.md
@@ -27,6 +28,10 @@ Latest Mattermost context, if available:
 
 !`if [ -s ai/inbox/mattermost-latest.md ]; then cat ai/inbox/mattermost-latest.md; elif [ -s scripts/mattermost/generated/mattermost_context.jsonl ]; then cat scripts/mattermost/generated/mattermost_context.jsonl; else echo "No Mattermost context available."; fi`
 
+Detailed active work item files, if available:
+
+!`if [ -d ai/work-items ]; then for f in ai/work-items/*.md; do case "$f" in *README.md|*index.md) continue;; esac; echo "\n### $f"; cat "$f"; done; else echo "No work item files available."; fi`
+
 User draft or rough notes:
 
 $ARGUMENTS

.opencode/commands/mattermost-sync.md

@@ -22,7 +22,8 @@ Then:
 - automatically promote explicit, project-relevant, high-confidence facts
 - default destination is `ai/logs/$(date +%F).md`
 - update `ai/state/current.md` only for facts that materially change the current work window
-- update `ai/state/work-items.md` for explicit Jira IDs, approved titles, points, scope, and status notes
+- update `ai/work-items/*.md` for explicit Jira IDs, approved titles, points, scope, and status notes
+- keep `ai/state/work-items.md` aligned as the compact summary of active ticket files
 - do not write tooling noise, sync status, or generic chat chatter into project memory
 - if a fact is ambiguous, skip it rather than asking the user what to do
 

.opencode/commands/promote-project-context.md

@@ -12,6 +12,7 @@ Read:
 @ai/context/systems/index.md
 @ai/context/workstreams/index.md
 @ai/context/process/index.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/workspace-model.md
@@ -41,6 +42,7 @@ Instructions:
 - Update the smallest correct set of files among:
   - `ai/logs/$(date +%F).md`
   - `ai/state/current.md`
+  - `ai/work-items/*.md`
   - `ai/state/work-items.md`
   - `ai/context/project.md`
   - `ai/context/systems/*.md`

.opencode/commands/slack-import.md

@@ -30,6 +30,7 @@ Read:
 @ai/context/process/index.md
 @ai/context/people/index.md
 @ai/context/people/manager.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/agent-memory-rules.md

.opencode/commands/standup.md

@@ -18,6 +18,7 @@ Read:
 @ai/context/process/communication.md
 @ai/context/process/jira-story-rules.md
 @ai/context/people/manager.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/communication-rules.md
@@ -35,6 +36,10 @@ Latest Mattermost context, preferring inbox and falling back to generated JSONL:
 
 !`if [ -s ai/inbox/mattermost-latest.md ]; then cat ai/inbox/mattermost-latest.md; elif [ -s scripts/mattermost/generated/mattermost_context.jsonl ]; then cat scripts/mattermost/generated/mattermost_context.jsonl; else echo "No Mattermost context available."; fi`
 
+Detailed active work item files, if available:
+
+!`if [ -d ai/work-items ]; then for f in ai/work-items/*.md; do case "$f" in *README.md|*index.md) continue;; esac; echo "\n### $f"; cat "$f"; done; else echo "No work item files available."; fi`
+
 Before drafting:
 
 - update workspace memory if the refreshed context introduced clear high-confidence project facts

.opencode/commands/story-draft.md

@@ -27,6 +27,7 @@ Read:
 @ai/context/process/jira-story-rules.md
 @ai/context/people/manager.md
 @ai/context/people/index.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/communication-rules.md
@@ -40,6 +41,10 @@ Latest Mattermost context, if available:
 
 !`if [ -s ai/inbox/mattermost-latest.md ]; then cat ai/inbox/mattermost-latest.md; elif [ -s scripts/mattermost/generated/mattermost_context.jsonl ]; then cat scripts/mattermost/generated/mattermost_context.jsonl; else echo "No Mattermost context available."; fi`
 
+Detailed active work item files, if available:
+
+!`if [ -d ai/work-items ]; then for f in ai/work-items/*.md; do case "$f" in *README.md|*index.md) continue;; esac; echo "\n### $f"; cat "$f"; done; else echo "No work item files available."; fi`
+
 Requirements:
 
 - Preserve the exact technical meaning of the input

.opencode/commands/sync-context.md

@@ -15,6 +15,7 @@ Read:
 @ai/context/process/context-maintenance.md
 @ai/context/people/manager.md
 @ai/context/people/index.md
+@ai/work-items/index.md
 @ai/state/current.md
 @ai/state/work-items.md
 @knowledge/workspace-model.md
@@ -35,6 +36,7 @@ Instructions:
 - Decide whether the new information belongs in:
   - today's log
   - `ai/state/current.md`
+  - `ai/work-items/*.md`
   - `ai/state/work-items.md`
   - `ai/context/project.md`
   - `ai/context/systems/`