structurelisted

# Structure Skill (Stage 3) This skill extracts work items from the project and structures them as Gastown Beads and Convoys. ## When to Use Use this skill when: - Have completed Stage 1 (Discover) and optionally Stage 2 (Plan) - Ready to create actionable work items - Want to structure work for Gastown multi-agent execution - Need to bundle related tasks for efficient assignment ## Output Structure ``` project/ ├── .gt/ │ ├── beads/ │ │ ├── gt-abc12.json # Individual work items │ │ ├── gt-def34.json │ │ └── ... │ └── convoys/ │ ├── convoy-001.json # Bundled work assignments │ └── ... └── [existing project files] ``` --- ## Part 1: Bead Extraction ### Extraction Sources (Priority Order) Scan for work items in: 1. **GitHub Issues** (most authoritative) ```bash gh issue list --state open --json number,title,body,labels ``` 2. **PRD Documents** - `docs/*.md` with user stories - `docs/PRD*.md` files 3. **TODO Comments in Source Code** - `// TODO:`, `# TODO:`, `/* TODO */` - `// FIXME:`, `// HACK:`, `// XXX:` 4. **Existing Roadmap Outputs** - `scopecraft/EPICS_AND_STORIES.md` (from Stage 2) - `scopecraft/OPEN_QUESTIONS.md` 5. **Backlog Files** - `BACKLOG.md`, `TODO.md` - `docs/backlog/`, `docs/roadmap/` ### Bead Schema Aligned with the real `bd` Issue schema (from `github.com/steveyegge/beads`): ```json { "$schema": "bead-v1", "id": "gt-abc12", "title": "Add user authentication", "description