@orderful/droid 0.37.0 → 0.39.0

package/src/tools/status-update/skills/status-update/references/formatting.md

@@ -0,0 +1,203 @@
+# Formatting Reference
+
+Detailed formatting rules for status updates.
+
+## Status Emoji
+
+| Status | Emoji | Display Text |
+|--------|-------|--------------|
+| `on_track` | `:large_green_circle:` | On track |
+| `at_risk` | `:large_yellow_circle:` | At risk |
+| `blocked` | `:red_circle:` | Blocked |
+
+## Phase Checklist
+
+### Phases in Order
+
+1. `discovery` - Research and requirements gathering
+2. `post_discovery_feedback` - Incorporating discovery feedback
+3. `design` - Prototype and design work
+4. `post_design_feedback` - Incorporating design feedback
+5. `prd` - Writing PRD
+6. `tech_design` - Writing Tech Design
+7. `development` - Active implementation
+8. `qa` - QA & Testing
+9. `release` - Released to production
+
+### Phase Emoji
+
+| State | Emoji |
+|-------|-------|
+| completed | `:check:` |
+| current | `:work-in-progress-sign:` |
+| upcoming | `:waiting-to-start:` |
+
+### Collapsed Groups
+
+When all phases in a group are completed or upcoming (not current), collapse them:
+
+| Group | Phases | Collapsed Name |
+|-------|--------|----------------|
+| 1 | discovery, post_discovery_feedback | "Discovery & Post-Discovery Feedback" |
+| 2 | design, post_design_feedback | "Prototype, Design & Post-Design Feedback" |
+| 3 | prd, tech_design | "PRD & Tech Design" |
+| 4 | development | "Development" |
+| 5 | qa, release | "QA → Release" |
+
+### Display Rules
+
+1. **Completed phases** - Collapse into groups, show with `:check:`
+2. **Current phase** - Show on its own line with `:work-in-progress-sign:` and **bold**
+3. **Upcoming phases** - Collapse into chain with `→`, show with `:waiting-to-start:`
+
+### Examples
+
+**Current = `development`:**
+```
+*Where we're at*
+:check: Discovery & Post-Discovery Feedback
+:check: Prototype, Design & Post-Design Feedback
+:check: PRD & Tech Design
+:work-in-progress-sign: *Development*
+:waiting-to-start: QA → Release
+```
+
+**Current = `prd`:**
+```
+*Where we're at*
+:check: Discovery & Post-Discovery Feedback
+:check: Prototype, Design & Post-Design Feedback
+:work-in-progress-sign: *PRD*
+:waiting-to-start: Tech Design → Development → QA → Release
+```
+
+**Current = `post_discovery_feedback`:**
+```
+*Where we're at*
+:check: Discovery
+:work-in-progress-sign: *Post-Discovery Feedback*
+:waiting-to-start: Prototype, Design & Post-Design Feedback → PRD & Tech Design → Development → QA → Release
+```
+
+**Current = `design`:**
+```
+*Where we're at*
+:check: Discovery & Post-Discovery Feedback
+:work-in-progress-sign: *Prototype/Design*
+:waiting-to-start: Post-Design Feedback → PRD & Tech Design → Development → QA → Release
+```
+
+## Links Footer
+
+Only include links that are configured in project metadata:
+
+```
+:link: <{prd_url}|PRD> · <{tech_design_url}|Tech Design> · <{figma_url}|Figma>
+```
+
+Omit any link that isn't set. If no links configured, omit the entire footer.
+
+## Full Message Template
+
+```
+*Status:* {status_emoji} *{status_text}*
+
+*Where we're at*
+{phase_checklist}
+
+*In flight this week*
+• {bullet 1}
+• {bullet 2}
+
+*Up next*
+• {bullet 1}
+• {bullet 2}
+
+{links_footer}
+
+Posted with help from :droid:{ & :codex: if used}
+```
+
+## Crosspost Template (Summary Version)
+
+```
+*{project_title}*
+
+{status_line}
+{current_phase_only - e.g., ":work-in-progress-sign: *Development*"}
+
+{in_flight_section}
+
+:link: <{message_url}|View full update>
+```
+
+## Example Full Output
+
+**Example 1: Development phase, on track**
+```
+*Status:* :large_green_circle: *On track*
+
+*Where we're at*
+:check: Discovery & Post-Discovery Feedback
+:check: Prototype, Design & Post-Design Feedback
+:check: PRD & Tech Design
+:work-in-progress-sign: *Development*
+:waiting-to-start: QA → Release
+
+*In flight this week*
+• Implementing scenario template API
+• Adding copy endpoint for templates
+
+*Up next*
+• Fan-out orchestration design
+• Integration tests
+
+:link: <url|PRD> · <url|Tech Design> · <url|Figma>
+
+Posted with help from :droid: & :codex:
+```
+
+**Example 2: PRD phase, at risk**
+```
+*Status:* :large_yellow_circle: *At risk*
+
+*Where we're at*
+:check: Discovery & Post-Discovery Feedback
+:check: Prototype, Design & Post-Design Feedback
+:work-in-progress-sign: *PRD*
+:waiting-to-start: Tech Design → Development → QA → Release
+
+*In flight this week*
+• Finalising requirements with stakeholders
+• Waiting on legal review for data handling
+
+*Up next*
+• Tech design kickoff
+
+:link: <url|PRD>
+
+Posted with help from :droid: & :codex:
+```
+
+**Example 3: No Slack, printed to terminal**
+```
+Status: On track
+
+Where we're at
+✓ Discovery & Post-Discovery Feedback
+✓ Prototype, Design & Post-Design Feedback
+→ Development
+○ QA → Release
+
+In flight this week
+• Building the feature
+• Writing tests
+
+Up next
+• Code review
+• QA handoff
+
+---
+Tip: To post this to Slack, add slack.channel to your project's CONTEXT.md
+and set SLACK_USER_TOKEN in your environment.
+```

package/src/tools/tech-design/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-tech-design",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Technical design authoring tool for engineers. Create structured tech design docs with /tech-design start, iterate in brain, publish to codex. Three-document approach: research doc (codebase discoveries) + thought doc (design workspace) + roll-up (clean summary for review).",
   "author": {
     "name": "Orderful",
@@ -12,5 +12,11 @@
     "droid",
     "ai",
     "tech-design"
+  ],
+  "skills": [
+    "./skills/tech-design/SKILL.md"
+  ],
+  "commands": [
+    "./commands/tech-design.md"
   ]
 }

package/src/tools/tech-design/TOOL.yaml

@@ -1,6 +1,6 @@
 name: tech-design
 description: "Technical design authoring tool for engineers. Create structured tech design docs with /tech-design start, iterate in brain, publish to codex. Three-document approach: research doc (codebase discoveries) + thought doc (design workspace) + roll-up (clean summary for review)."
-version: 0.2.5
+version: 0.3.0
 status: beta
 
 includes:

package/src/tools/tech-design/commands/tech-design.md

@@ -13,6 +13,7 @@ argument-hint: "[start --from codex:{project} | draft [section] | think [topic]
 ## Examples
 
 - `/tech-design start --from codex:billing-v2` → Create research + thought docs from codex project
+- `/tech-design search billing` → Find and resume existing billing design
 - `/tech-design draft rollout` → Auto-generate the rollout section
 - `/tech-design think API design` → Guided exploration of API design, update research doc
 - `/tech-design gaps` → Show checklist of missing/empty sections
@@ -22,6 +23,7 @@ argument-hint: "[start --from codex:{project} | draft [section] | think [topic]
 
 ```
 /tech-design start --from codex:{project}  # Create research + thought docs
+/tech-design search {term}                 # Find and resume existing design
 /tech-design draft [section]               # Auto-generate section
 /tech-design think [topic]                 # Guided exploration
 /tech-design gaps                          # Missing sections checklist

package/src/tools/tech-design/skills/tech-design/SKILL.md

@@ -45,13 +45,15 @@ Tech-design has no configuration of its own. It delegates to:
 - **Brain skill** for research + thought doc location (`brain_dir`, `inbox_folder`)
 - **Codex skill** for repository location (`codex_repo`)
 
+**Overrides:** This skill supports user-defined overrides. See `/droid` skill § Skill Overrides.
+
 ## Three-Document Approach
 
-| Document        | Created When | Purpose                                         | Location      | Audience    |
-| --------------- | ------------ | ----------------------------------------------- | ------------- | ----------- |
-| **Research**    | `/start`     | Deep dive: codex project + codebase discoveries | Brain         | Author + AI |
-| **Thought doc** | `/start`     | Design iteration: decisions, @mentions, drafts  | Brain         | Author + AI |
-| **Roll-up**     | `/publish`   | Clean summary: decisions only, reviewable       | Codex project | Reviewers   |
+| Document        | Created When | Purpose                                         | Location                                         | Audience    |
+| --------------- | ------------ | ----------------------------------------------- | ------------------------------------------------ | ----------- |
+| **Research**    | `/start`     | Deep dive: codex project + codebase discoveries | `{brain_dir}/{inbox?}/tech-designs/{name}/`      | Author + AI |
+| **Thought doc** | `/start`     | Design iteration: decisions, @mentions, drafts  | `{brain_dir}/{inbox?}/tech-designs/{name}/`      | Author + AI |
+| **Roll-up**     | `/publish`   | Clean summary: decisions only, reviewable       | `{codex_repo}/projects/{name}/TECH-DESIGN.md`    | Reviewers   |
 
 **Why three documents?**
 
@@ -91,10 +93,11 @@ Both thought doc and roll-up are published to codex. Research doc stays in brain
 | Command                                     | Action                                                   |
 | ------------------------------------------- | -------------------------------------------------------- |
 | `/tech-design start --from codex:{project}` | Create research + thought docs, pull PRD/DESIGN context  |
+| `/tech-design search {term}`                | Find and resume existing design by name                  |
 | `/tech-design draft [section]`              | Auto-generate from research doc + codebase exploration   |
 | `/tech-design think [topic]`                | Guided exploration, updates research doc with findings   |
 | `/tech-design gaps`                         | Checklist of missing/empty sections                      |
-| `/tech-design publish`                      | Generate roll-up, publish thought doc + roll-up to codex |
+| `/tech-design publish`                      | Draft or ready publish to codex with GitHub PR           |
 
 ## Conversational Skill Matching
 
@@ -113,10 +116,37 @@ Commands are explicit entry points, but most usage will be natural conversation.
 
 **Trigger:** `/tech-design start --from codex:{project}` or user wants to start a new tech design
 
-**TLDR:** Create research + thought docs in brain, pull PRD/DESIGN context from codex, perform deep codebase dive, set as active.
+**TLDR:** Create unified folder `{brain_dir}/{inbox?}/tech-designs/{name}/` with research + thought docs, pull PRD/DESIGN context from codex, perform deep codebase dive, set as active.
 
 **Full procedure:** See `references/start.md` for detailed implementation steps, error handling, and examples.
 
+## Finding Existing Designs
+
+**Trigger:** `/tech-design search {term}` or user wants to resume existing design
+
+**TLDR:** Glob `{brain_dir}/{inbox?}/tech-designs/*/`, fuzzy match on name, read thought-doc.md, list folder contents, set as active.
+
+**Procedure:**
+
+1. Get brain config: `droid config --get tools.brain`
+2. Parse `brain_dir` and `inbox_folder` from JSON
+3. Construct search path:
+   - If `inbox_folder` set: Use full inbox path
+   - Otherwise: Search directly in `{brain_dir}/tech-designs/`
+4. Glob for designs: `{search_path}/tech-designs/*/`
+5. Fuzzy match folder names against search term
+6. If multiple matches: Prompt user to select
+7. If single match or after selection:
+   - Read `thought-doc.md` fully
+   - List all files in folder
+   - Set thought-doc as active for session
+8. Output paths and available commands
+
+**Error handling:**
+- No matches: "No tech designs found matching '{term}'. Start new with `/tech-design start`"
+- Brain not configured: Direct to `/brain` command
+- thought-doc.md missing: "Found folder but no thought-doc.md - folder may be incomplete"
+
 ## Drafting Content
 
 **Trigger:** `/tech-design draft [section]` or user wants to generate content
@@ -147,9 +177,9 @@ Commands are explicit entry points, but most usage will be natural conversation.
 
 **Trigger:** `/tech-design publish` or user wants to create PR for review
 
-**TLDR:** Generate clean roll-up from thought doc, publish thought doc + roll-up to codex (research doc stays in brain).
+**TLDR:** Draft (share for feedback) or Ready (complete design). Draft copies tech-design/ folder only → draft PR. Ready generates rollup + copies all files → regular PR. Brain files never deleted.
 
-**Full procedure:** See `references/publish.md` for roll-up generation, git workflow, quality checklist, and examples.
+**Full procedure:** See `references/publish.md` for draft/ready workflows, roll-up generation, git workflow, and examples.
 
 ## Active Doc Tracking