@orderful/droid 0.25.2 → 0.26.0

package/src/tools/tech-design/skills/droid-tech-design/references/thought-doc-template.md

@@ -0,0 +1,72 @@
+# Thought Doc Template
+
+Used when creating thought doc via `/brain plan tech-design-{project}`.
+
+```markdown
+# [Tech Design] {Project Name}
+
+**Type:** plan
+**Status:** exploring
+**Created:** {YYYY-MM-DD}
+**PRD:** [[codex:projects/{project}/PRD]]
+**Research:** [[tech-design-{project}-research]]
+
+Tech design for {project}.
+
+## Background
+
+{Why we're doing this - 2-3 paragraphs from PRD}
+
+{What problem we're solving, who it's for, why it matters}
+
+See research doc for codebase context and discovered patterns.
+
+## Proposal
+
+{What we're building - to be drafted}
+
+## Open Questions
+
+{What we don't know yet - to be explored}
+```
+
+## Variable Substitutions
+
+| Variable         | Example                 | Notes                       |
+| ---------------- | ----------------------- | --------------------------- |
+| `{Project Name}` | "Transaction Templates" | Human-readable project name |
+| `{YYYY-MM-DD}`   | "2026-01-10"            | Current date                |
+| `{project}`      | "transaction-templates" | Codex project slug          |
+
+## Philosophy
+
+**Start minimal:** 3 sections (Background, Proposal, Open Questions)
+
+**Gaps surface more:** Use `/tech-design gaps` to discover what sections to add (Data Model, API Surface, Rollout Plan, etc.)
+
+**Research doc separation:** The thought doc references the research doc but doesn't duplicate codebase discoveries. Keep the thought doc focused on architectural decisions.
+
+## Sections That Can Be Added
+
+Via `/tech-design draft {section}` or `/tech-design gaps`:
+
+- **Scope** - What's in/out explicitly
+- **Data Model** - Tables, schemas, types
+- **API Surface** - Endpoints, methods, interfaces
+- **Implementation Plan** - Step-by-step approach
+- **Key Decisions** - Options considered, what we chose and why
+- **Trade-off Analysis** - Pros/cons of approach
+- **Risks & Mitigations** - What could go wrong, how to handle it
+- **Metrics** - What we'll measure
+- **Rollout Plan** - Phased deployment, feature flags, rollback
+- **Security Considerations** - Auth, validation, audit logging
+
+## Template Evolution
+
+The template starts with 3 sections, but the thought doc grows based on:
+
+1. **User adds via `/draft {section}`** - AI generates section from research
+2. **User explores via `/think {topic}`** - May add sections organically
+3. **User identifies via `/gaps`** - Shows what's missing, suggests adding
+
+The minimal start reduces cognitive load. Sections appear when needed.