Integrate get-shit-done methodology

[oldsj]

Overview

Integrate the methodology from the get-shit-done Claude Code plugin natively into mainloop to provide structured, reliable AI-driven development workflows.

Core Methodology to Integrate

The GSD plugin provides a four-phase workflow system:

1. Ideation — Extract project vision through guided questions, creating PROJECT.md
2. Roadmap — Break the project into phases with STATE.md for persistent memory
3. Execution — Plan atomic tasks (max 3 per phase) and execute via fresh subagents
4. Iteration — Ship, adjust, or insert urgent work without rebuilding

Key Features to Implement

Context Engineering

• Maintain structured documentation (PROJECT.md, ROADMAP.md, STATE.md, PLAN.md)
• Ensure Claude always references these files to prevent context degradation
• Provide persistent memory across long development sessions

Subagent Isolation

• Each task runs in a dedicated context window
• Prevents accumulated context pollution from previous work
• Maintains full quality for each individual task

XML-Structured Tasks

• Use precise XML formatting for task plans
• Include action steps, verification commands, and completion criteria
• Eliminate ambiguity in task execution

Atomic Git Commits

• Each completed task gets its own commit
• Enable precise bisection and independent reversion
• Maintain clear development history

Brownfield Support

• Map existing codebases before planning changes
• Document stack, architecture, conventions, and concerns
• Support adding to or modifying existing projects

Implementation Considerations

• How to integrate this workflow with mainloop's existing agent spawning
• Whether to make this an optional mode or core functionality
• How to handle the structured documentation files
• Integration with mainloop's GitHub workflow

Design Philosophy

As the GSD plugin states: "The complexity is in the system, not in your workflow." The goal is to automate the engineering layer behind AI development while keeping the user experience simple.

Reference

• Original plugin: https://github.com/glittercowboy/get-shit-done
• README with full methodology: https://github.com/glittercowboy/get-shit-done/blob/main/README.md