Skip to content

feat: add task list visibility to all Nelson execution modes#96

Merged
harrymunro merged 2 commits intomainfrom
feature/task-list-visibility
Apr 10, 2026
Merged

feat: add task list visibility to all Nelson execution modes#96
harrymunro merged 2 commits intomainfrom
feature/task-list-visibility

Conversation

@harrymunro
Copy link
Copy Markdown
Collaborator

Summary

  • Adds TaskCreate/TaskUpdate instructions for admiral-level visibility tracking in all execution modes (not just agent-team), so users can see mission progress via Ctrl+T
  • Refines the Mode-Tool Consistency Gate to distinguish between "TaskCreate for coordination" (agent-team only) and "TaskCreate for visibility" (all modes)
  • Updates tool-mapping.md with a new visibility tracking operation, exception note for subagents mode, and corrected anti-pattern

Changes

SKILL.md

  • Step 2: New "Task List Visibility" block — admiral creates TaskCreate entries for every battle plan task after drafting
  • Step 3: Refined Mode-Tool Consistency Gate — clarifies captain vs admiral task tool usage; adds single-session mode bullet
  • Step 3: New "Task Status Updates" block — update tasks with owners and in_progress status after formation
  • Step 5: New checkpoint sub-bullet — mark completed tasks via TaskUpdate during quarterdeck rhythm
  • Step 7: New "Task List Cleanup" block — verify task entries reflect final state at stand-down

tool-mapping.md

  • New table row: Track task visibility (admiral) → all modes
  • New exception bullet under subagents mode: admiral uses TaskCreate/TaskUpdate for session-level visibility
  • Updated anti-pattern: clarifies it's captains (not the admiral) who shouldn't use TaskCreate in subagents mode

Test plan

  • Run Nelson in subagents mode — verify TaskCreate entries appear in Ctrl+T task list
  • Run Nelson in single-session mode — verify task progress updates via TaskUpdate
  • Run Nelson in agent-team mode — verify existing behaviour unchanged (tasks serve both visibility and coordination)
  • Verify Mode-Tool Consistency Gate correctly prevents captains from using Task tools in subagents mode

Nelson previously only used TaskCreate in agent-team mode, leaving users
with no visible task progress in subagents or single-session modes. The
admiral now creates TaskCreate entries for every battle plan task in all
modes, making mission progress visible via Claude Code's Ctrl+T overlay.
- Move TaskCreate from Step 2 to Step 3 (after mode selection) to resolve
  temporal ordering issue where tasks were created before mode was known
- Update wrong-ensign.md standing order with admiral exception for
  TaskCreate/TaskUpdate/TaskList in subagents mode, and add single-session
  mode tool availability
- Extend TaskList/TaskGet authorization for admiral in subagents and
  single-session modes across SKILL.md, tool-mapping.md, and wrong-ensign.md
- Fix Crew Briefing to reference TaskUpdate only (tasks already exist from
  earlier in Step 3, not TaskCreate + TaskUpdate)
- Add single-session mode tool availability lists to tool-mapping.md and
  wrong-ensign.md
- Add footnote system to tool-mapping.md disambiguating coordination vs
  visibility usage of task tools
- Add task entry update to relief-on-station procedure (step 8)
- Add task entry cleanup to scuttle-and-reform abort procedure (step 4)
- Remove implementation plan doc (work ticket, not documentation)
- Fix pre-existing "Step 6" -> "Step 7" reference in Mission Complete Gate
- Clarify "no script calls" as "no nelson-data.py script calls" in Step 2
- Replace fragile "Ctrl+T" with "Claude Code task list" in Step 7
@harrymunro harrymunro merged commit 4fbcc04 into main Apr 10, 2026
6 checks passed
@harrymunro harrymunro deleted the feature/task-list-visibility branch April 10, 2026 19:44
harrymunro added a commit that referenced this pull request Apr 10, 2026
Integrate six PRs merged to main since this branch diverged:
- PR #89: formation consolidation (form, headless commands)
- PR #90: path-scoped auto-discovery
- PR #91: typed handoff packet
- PR #92: hook enforcement layer
- PR #93: deterministic phase engine
- PR #96: task list visibility

Port new commands (form, headless, handoff, recover) into the
modular architecture. Add phase field support to lifecycle commands
for compatibility with the phase engine. All 234 tests pass.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant