Skip to content

feat: add session-workflow skill and TODO.md for multi-session AI development#15

Merged
nullhack merged 1 commit intomainfrom
feat/session-workflow-skill
Mar 13, 2026
Merged

feat: add session-workflow skill and TODO.md for multi-session AI development#15
nullhack merged 1 commit intomainfrom
feat/session-workflow-skill

Conversation

@nullhack
Copy link
Owner

Summary

  • Introduces a session-based development pattern that lets complex projects span multiple AI sessions — any AI can continue from where the last one stopped, using TODO.md as shared state
  • Adds a new session-workflow skill with a complete start/end protocol, TODO.md format specification, task status conventions, and worked examples
  • Adds a pre-filled TODO.md template (8 phases, Session Log table, Notes for Next Session section) so every generated project starts with a clear roadmap
  • Wires the pattern into the developer agent (session start/end protocol at the top of instructions) and documents it in AGENTS.md and README.md

Changes

File Change
.opencode/skills/session-workflow/SKILL.md New skill — full session protocol
TODO.md New template — phased roadmap with session log
.opencode/agents/developer.md Session start/end protocol + skill listed
AGENTS.md Session-based development section added
README.md Multi-session section + TODO.md in project structure

Why

Large projects cannot be completed in a single AI context window. This pattern makes it practical to build them incrementally: each session reads TODO.md, picks up one phase, and leaves a clean handoff for the next session — whether that's the same AI or a different one.

…elopment

Introduces a session-based development pattern that allows complex projects
to be built across multiple AI sessions, with any AI able to continue from
where the last session stopped.

- Add .opencode/skills/session-workflow/SKILL.md: full session start/end
  protocol, TODO.md format spec, status conventions and examples
- Add TODO.md template: phased roadmap with Session Log and handoff notes
- Update developer.md: session start/end protocol at top of agent instructions
- Update AGENTS.md: session-based development section, session-workflow skill listed
- Update README.md: multi-session development section, TODO.md in project structure
@nullhack nullhack merged commit 0004b33 into main Mar 13, 2026
@nullhack nullhack deleted the feat/session-workflow-skill branch March 13, 2026 06:42
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