drt-method 1.0.0

package/AGENTS.md

@@ -0,0 +1,45 @@
+# DRT-METHOD
+
+Standalone fork of an AI-assisted delivery framework. Install from this repo — not the DRT ecosystem.
+
+User guide: [README.md](README.md). Architecture: [ARCHITECTURE.md](ARCHITECTURE.md).
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `src/drt-skills/` | Main workflow across 4 phases (analysis → planning → solutioning → implementation) |
+| `src/core-skills/` | Shared skills (`drt-help`, `drt-customize`, `drt-party-mode`, …) |
+| `src/scripts/` | Python runtime — copied to `_drt/scripts/` on install |
+| `tools/installer/` | CLI entry: `drt` / `drt-cli.js` |
+| `removals.txt` | Legacy skill IDs to remove on upgrade |
+| `drt-modules.yaml` | External module registry (currently empty) |
+
+After install in a project: `.agents/skills/` (Cursor), `_drt/` (config + scripts).
+
+## Conventions
+
+- Skill prefix: `drt-*`
+- Install folder in target project: `_drt/`
+- Module code: `drt`
+- **Do not change workflow step logic** unless the user explicitly asks
+- Keep agent personas: DRT001, DRT002, DRT003, DRT004, DRT005, DRT006
+- Commits: Conventional Commits — only commit when the user requests it
+
+## Editing code
+
+- Minimal diffs; match existing conventions
+- No comments in code
+- Do not add new `.md` files unless the user asks
+- After installer or skill changes, smoke-test install:
+
+```bash
+node tools/installer/drt-cli.js install --directory /tmp/drt-test --modules drt --tools cursor --yes
+```
+
+## Quick install
+
+```bash
+npm ci
+node tools/installer/drt-cli.js install --directory <project> --modules drt --tools cursor --yes
+```

package/GETTING-STARTED.md

@@ -0,0 +1,269 @@
+# DRT Method — Getting Started
+
+This project has **DRT Method** installed — a system of AI agents and workflows that takes a product idea from analysis → planning → design → code in a structured way.
+
+You use DRT directly in **Cursor chat**: describe what you want in natural language, or invoke a skill with `@drt-<skill-name>`. Agents show a menu of workflow codes when you talk to them.
+
+---
+
+## Where to Start
+
+### Step 0 — Not sure what to do next?
+
+Type in Cursor chat:
+
+```
+drt help
+```
+
+Or invoke `@drt-help`, or describe your situation:
+
+```
+drt help — I want to build a camera monitoring dashboard, where do I start?
+```
+
+`drt-help` will:
+
+- Read artifacts already in `_drt-output/`
+- Determine which phase you are in
+- Recommend the next step (required or optional)
+
+This is the safest starting point for newcomers.
+
+### Step 1 — Pick your path
+
+| Situation | Start with |
+|-----------|------------|
+| Idea still fuzzy | `drt help` → Phase 1 (analysis) |
+| You know exactly what to build | Talk to **DRT003** (PM) → create a PRD |
+| Project already has code | `generate project context` → then `drt help` |
+| Small bug fix or feature | `quick dev` or **IT** (Implement Task) |
+| Ready to code with gates | `@drt-implement-task` or menu code **IT** |
+
+---
+
+## The 4 DRT Method Phases
+
+DRT splits the process into 4 phases. Each phase produces **artifacts** (documents) that feed the next phase.
+
+```
+Idea → [1. Analysis] → [2. Planning] → [3. Solutioning] → [4. Implementation] → Code
+```
+
+### Phase 1 — Analysis (optional)
+
+**Goal:** Clarify the problem before committing to build.
+
+| Chat / skill | Output |
+|--------------|--------|
+| `@drt-brainstorming` / `brainstorm project` | Ideas, directions |
+| `@drt-market-research` / `market research` | Market analysis |
+| `@drt-domain-research` / `domain research` | Deep industry understanding |
+| `@drt-technical-research` / `technical research` | Technical feasibility |
+| `@drt-product-brief` / `create brief` | Short product brief |
+| `@drt-prfaq` / `PRFAQ challenge` | Stress-test the idea (Amazon-style) |
+
+**Suggested agent:** **DRT001** (Business Analyst)
+
+**When to skip:** You are already certain about what to build.
+
+---
+
+### Phase 2 — Planning
+
+**Goal:** Answer *what to build, for whom, and why* — no code yet.
+
+| Chat / skill | Output | Required? |
+|--------------|--------|-----------|
+| `@drt-prd` / `create PRD` | PRD document | Yes |
+| `@drt-ux` / `create UX` | UX spec, wireframes | Recommended if UI-heavy |
+
+**Suggested agents:** **DRT003** (Product Manager), **DRT004** (UX Designer)
+
+**Saved to:** `_drt-output/planning-artifacts/`
+
+---
+
+### Phase 3 — Solutioning
+
+**Goal:** Move from **WHAT** (what to build) to **HOW** (how to build it).
+
+| Chat / skill | Output | Required? |
+|--------------|--------|-----------|
+| `@drt-architecture` / `create architecture` | Architecture spine | Yes |
+| `@drt-create-epics-and-stories` | Epics + user stories | Yes |
+| `@drt-check-implementation-readiness` | Alignment report | Yes |
+
+**Suggested agents:** **DRT005** (Architect), **DRT003** (PM)
+
+**Saved to:** `_drt-output/planning-artifacts/`
+
+**Implementation Readiness** should pass before you start coding at scale.
+
+---
+
+### Phase 4 — Implementation
+
+**Goal:** Code story by story, review, repeat.
+
+**Kickoff:**
+
+```
+run sprint planning
+```
+
+**Story cycle:**
+
+```
+Create Story → Validate Story → Dev Story → Code Review
+                                    ↑            |
+                                    └── fixes ───┘
+```
+
+| Chat / skill | What it does |
+|--------------|--------------|
+| `create the next story` (**CS**) | Prepare full context for a story |
+| `dev this story` (**DS**) | DRT006 implements code + tests |
+| `run code review` (**CR**) | Quality review |
+| `check sprint status` (**SS**) | Sprint progress |
+| `run a retrospective` (**ER**) | Lessons learned (end of epic) |
+
+**Coding shortcuts:**
+
+| Skill | Code | When |
+|-------|------|------|
+| `drt-implement-task` | **IT** | Full flow: plan → approve → implement → QC → review |
+| `drt-quick-dev` | **QQ** | Fast path or resume a quick-dev spec |
+| `drt-dev-story` | **DS** | Story file already in sprint plan |
+
+**Suggested agent:** **DRT006** (Senior Developer)
+
+**Saved to:** `_drt-output/implementation-artifacts/`
+
+---
+
+## Specialized Agents
+
+Invoke an agent by ID or role in chat:
+
+| Agent | Invoke | Specialty |
+|-------|--------|-----------|
+| DRT001 | `hey DRT001`, `business analyst` | Research, analysis, brief |
+| DRT002 | `hey DRT002`, `tech writer` | Technical documentation |
+| DRT003 | `hey DRT003`, `product manager` | PRD, epics, stories |
+| DRT004 | `hey DRT004`, `UX designer` | UX/UI design |
+| DRT005 | `hey DRT005`, `architect` | System architecture |
+| DRT006 | `hey DRT006`, `developer` | Code, implementation |
+
+Each agent greets you, shows a **menu** of workflow codes, and dispatches the matching skill when you choose.
+
+**Multiple agents at once:**
+
+```
+party mode — [question that needs multiple perspectives]
+```
+
+---
+
+## Two Ways to Work
+
+### Option 1 — Through an agent (guided)
+
+```
+hey DRT003 → choose PRD → DRT003 walks you through each step
+```
+
+Best when you are new or unfamiliar with the workflows.
+
+### Option 2 — Direct workflow (fast)
+
+```
+@drt-prd
+@drt-architecture
+dev this story
+quick dev
+@drt-implement-task
+```
+
+Best when you already know what you need.
+
+---
+
+## Shortcuts
+
+| Situation | Command |
+|-----------|---------|
+| Unsure of next step | `drt help` / `@drt-help` |
+| Brownfield project (existing code) | `generate project context` / **GPC** |
+| Small feature, skip full flow | `quick dev` / **QQ** |
+| Full coding task with review gates | **IT** / `@drt-implement-task` |
+| Major scope change mid-sprint | `correct course` / **CC** |
+| Customize agent or workflow | `customize drt` / `@drt-customize` |
+
+---
+
+## Example: camera-monitoring-dashboard
+
+### Full path (greenfield)
+
+```
+1. drt help
+2. hey DRT003 → PRD for GIS camera monitoring dashboard
+3. hey DRT004 → UX design
+4. hey DRT005 → architecture
+5. hey DRT003 → epics and stories
+6. check implementation readiness
+7. run sprint planning
+8. hey DRT006 → dev story 1, 2, 3...
+```
+
+### Fast path (clear idea already)
+
+```
+hey DRT003, create a PRD for the camera monitoring dashboard
+```
+
+After the PRD, type `drt help` for the next step.
+
+### Express path (small feature)
+
+```
+quick dev — add a filter for offline camera status
+```
+
+Or with full gates:
+
+```
+@drt-implement-task — add offline camera filter to the dashboard
+```
+
+---
+
+## Important Tips
+
+1. **Open a new chat for each major workflow** — cleaner context, better results.
+2. **`drt help` is your best friend** — use it whenever you are unsure what comes next.
+3. **Artifacts are the source of truth** — PRD, architecture, and story files in `_drt-output/` drive what agents build.
+4. **You do not need to memorize everything** — agents have menus; `_drt/_config/drt-help.csv` defines workflow order and phases.
+
+---
+
+## Reference
+
+| Topic | Where |
+|-------|--------|
+| Install & update | [README.md](README.md) in the DRT Method repo |
+| Workflow catalog | `_drt/_config/drt-help.csv` |
+| Customize overrides | `_drt/custom/` and `@drt-customize` |
+
+---
+
+## Newcomer Checklist
+
+- [ ] Run `drt help` and describe your project goal
+- [ ] Choose a path: full flow, quick dev (**QQ**), or implement task (**IT**)
+- [ ] Complete the PRD (Phase 2 — required)
+- [ ] Complete Architecture + Epics (Phase 3 — required)
+- [ ] Pass Implementation Readiness
+- [ ] Sprint planning → dev the first story
+- [ ] When lost: run `drt help` again

package/README.md

@@ -0,0 +1,233 @@
+# DRT Method
+
+Traditional AI tools do the thinking for you, producing average results. DRT agents and facilitated workflows act as expert collaborators who guide you through a structured process to bring out your best thinking in partnership with the AI.
+
+## Why DRT
+
+- **AI Intelligent Help** — Invoke `drt-help` anytime for guidance on what's next. It reads your phase, artifacts on disk, and the skill catalog to recommend the right step.
+- **Scale-Adaptive Delivery** — Fast path for small changes (`drt-quick-dev`), coaching path for full PRDs, optional UX when UI matters, rigor that scales from hobby builds to launch-ready products.
+- **Structured Workflows** — Agile best practices across four phases. Each workflow runs step-by-step with HALT points so you stay in control.
+- **Specialized Agents** — Six domain experts (DRT001–DRT006): Analyst, Tech Writer, PM, UX, Architect, Developer. Each has a menu that dispatches to the right workflow.
+- **Party Mode** — Bring multiple agent personas into one session to collaborate, debate, and stress-test ideas.
+- **Adversarial Code Review** — Multi-layer review with structured triage, patch handling, and sprint status sync.
+- **Complete Lifecycle** — Brainstorming → brief → PRD → architecture → epics → sprint → dev → review → retrospective.
+- **Project-Local Customization** — Override personas, menus, and paths in `_drt/custom/` without forking the framework.
+
+## Install
+
+**Requires:** [Node.js](https://nodejs.org) 20.12+
+
+Once `drt-method` is published to npm, open a terminal in your project folder and run:
+
+```bash
+npx drt-method install
+```
+
+`npx` downloads the installer, runs setup, and exits — no global install needed. The installer copies skills into the matching folder for each selected tool/IDE (for example `.claude/skills/` for Claude Code, `.agents/skills/` for Cursor or GitHub Copilot) and creates `_drt/` (config, scripts, manifest).
+
+> **Package not on npm yet?** Use [Install from GitHub](#install-from-github-before-drt-method-is-on-npm) below.
+
+After install, open the project in your AI IDE and invoke **`drt-help`** to see what to do next.
+
+**New to DRT?** Read [GETTING-STARTED.md](GETTING-STARTED.md) for phases, agents, chat commands, and examples.
+
+### Non-interactive (CI / scripted)
+
+```bash
+    npx drt-method install --directory /path/to/your-project --modules drt --tools claude-code|cursor|github-copilot --yes
+```
+
+Use `--tools` with one or more supported IDs such as `claude-code`, `cursor`, `github-copilot`, `codex`, `windsurf`, or `cline`. The installer accepts a comma-separated list, so you can target multiple IDEs or agent tools in one run. Run `npx drt-method install --list-tools` to see all supported IDs.
+
+Override module config (repeatable):
+
+```bash
+npx drt-method install --yes --modules drt --tools claude-code|cursor|github-copilot --set drt.project_knowledge=docs
+```
+
+### Update an existing install
+
+From the project that already has `_drt/`:
+
+```bash
+npx drt-method install
+```
+
+Choose update when prompted, or use `--action quick-update` to refresh skills while keeping your config.
+
+### Prerelease channel
+
+```bash
+npx drt-method@next install
+```
+
+### Install from GitHub (before `drt-method` is on npm)
+
+Use one of these until `npx drt-method install` works from the npm registry.
+
+**Option A — `npx` from GitHub** (no clone, one command):
+
+```bash
+npx --yes github:<your-org>/drt-method install --directory . --modules drt --tools claude-code|cursor|github-copilot --yes
+```
+
+Or with a full git URL:
+
+```bash
+npx --yes git+https://github.com/<your-org>/drt-method.git install --directory . --modules drt --tools claude-code|cursor|github-copilot --yes
+```
+
+**Option B — helper scripts** (clone + install in one step):
+
+Requires [Git](https://git-scm.com). Clone this repo (or copy the scripts), then run from the repo root:
+
+```bash
+# macOS / Linux
+./scripts/install-from-github.sh /path/to/your-project
+
+# Windows (PowerShell)
+.\scripts\install-from-github.ps1 C:\path\to\your-project
+```
+
+Default repo is `https://github.com/your-org/drt-method.git`. Point at your fork:
+
+```bash
+# bash
+DRT_REPO=https://github.com/<your-org>/drt-method.git ./scripts/install-from-github.sh .
+
+# PowerShell
+$env:DRT_REPO = "https://github.com/<your-org>/drt-method.git"
+.\scripts\install-from-github.ps1 .
+```
+
+The script clones DRT into a temp folder, runs `npm ci`, installs into your project, then deletes the temp folder.
+
+**Option C — manual clone** (contributors or full control):
+
+```bash
+git clone https://github.com/<your-org>/drt-method.git
+cd drt-method && npm ci
+node tools/installer/drt-cli.js install --directory /path/to/your-project --modules drt --tools claude-code|cursor|github-copilot --yes
+```
+
+Or link locally after clone: `npm link` in the repo, then `npx drt-method install` from your target project.
+
+### Contributors (working on this repo)
+
+Same as **Option C** above. Run `npm ci && npm run quality` before pushing changes to this repository.
+
+## Publish to npm (maintainers)
+
+The package name is **`drt-method`** (`package.json` → `bin.drt` / `bin.drt-method`). Users install with `npx drt-method install` after it is on the registry.
+
+### One-time setup
+
+1. Create an [npm](https://www.npmjs.com/signup) account.
+2. Log in locally:
+
+```bash
+npm login
+```
+
+3. Confirm the name is free (or use a scoped name like `@your-org/drt-method` and set `"publishConfig": { "access": "public" }`):
+
+```bash
+npm view drt-method version
+```
+
+4. Update `repository.url` in `package.json` to your real GitHub URL before the first publish.
+
+### Dry run (check tarball contents)
+
+```bash
+npm ci
+npm pack --dry-run
+```
+
+The tarball must include `tools/installer/`, `src/core-skills/`, `src/drt-skills/`, and `src/scripts/`. `.npmignore` excludes dev-only paths (tests, docs site, etc.).
+
+### Publish manually
+
+1. Bump `version` in `package.json` (semver).
+2. From a clean checkout:
+
+```bash
+npm ci
+npm publish --access public
+```
+
+First stable release uses the default `latest` tag. Prereleases (e.g. `6.11.0-next.0`) can be published with:
+
+```bash
+npm publish --tag next
+```
+
+Users then run `npx drt-method@next install`.
+
+### Publish via GitHub Actions (optional)
+
+Add repo secret **`NPM_TOKEN`** (npm → Access Tokens → **Automation** or **Publish**).
+
+On tag push or release, a workflow can run:
+
+```bash
+npm ci
+npm publish --provenance --access public
+```
+
+Use `--tag next` for prerelease builds and `--tag latest` for stable. After publish, verify:
+
+```bash
+npm view drt-method version
+npx drt-method@latest install --help
+```
+
+### After publish
+
+Update this README if the GitHub org or default `--modules` / `--tools` change. Users only need:
+
+```bash
+npx drt-method install
+```
+
+## How it works
+
+The installer copies skills into `.agents/skills/` (Cursor) and creates `_drt/` (config, scripts, manifest).
+
+Invoke **`drt-help`** to see your current phase and the recommended next skill.
+
+### Four phases
+
+| Phase | Goal | Example skills |
+|-------|------|----------------|
+| 1 — Analysis | Ideas, research, brief | `drt-brainstorming`, `drt-product-brief`, `drt-prfaq` |
+| 2 — Planning | PRD, UX | `drt-prd`, `drt-ux` |
+| 3 — Solutioning | Architecture, epics, readiness | `drt-architecture`, `drt-create-epics-and-stories` |
+| 4 — Implementation | Sprint, dev, review | `drt-implement-task`, `drt-sprint-planning`, `drt-dev-story`, `drt-code-review` |
+
+Full path: Analysis → PRD → (UX if UI-heavy) → Architecture → Epics/Stories → Sprint → Dev/Review.
+
+### Coding entry points
+
+| Skill | Code | When to use |
+|-------|------|-------------|
+| `drt-implement-task` | IT | Full flow: intent → plan (approve) → confirm libs → implement → QC → review → fix loop |
+| `drt-quick-dev` | QQ | Shortcut or resume an existing quick-dev spec |
+| `drt-dev-story` | DS | Story file already prepared in sprint plan |
+
+Invoke `@drt-implement-task` or talk to DRT006 and choose **IT**.
+
+### Agents
+
+| Name | Role |
+|------|------|
+| DRT001 | Business Analyst |
+| DRT002 | Technical Writer |
+| DRT003 | Product Manager |
+| DRT004 | UX Designer |
+| DRT005 | System Architect |
+| DRT006 | Senior Developer |
+
+### Customize
+
+Overrides live in `_drt/custom/`. Use the `drt-customize` skill to author them.

package/drt-modules.yaml

@@ -0,0 +1 @@
+modules: {}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "drt-method",
+  "version": "1.0.0",
+  "description": "DRT Method — structured AI-assisted agile development",
+  "keywords": [
+    "agile",
+    "ai",
+    "orchestrator",
+    "development",
+    "methodology",
+    "agents",
+    "drt"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drt-method/DRT-METHOD.git"
+  },
+  "license": "MIT",
+  "main": "tools/installer/drt-cli.js",
+  "bin": {
+    "drt": "tools/installer/drt-cli.js",
+    "drt-method": "tools/installer/drt-cli.js"
+  },
+  "scripts": {
+    "drt:install": "node tools/installer/drt-cli.js install",
+    "drt:uninstall": "node tools/installer/drt-cli.js uninstall",
+    "install:drt": "node tools/installer/drt-cli.js install"
+  },
+  "dependencies": {
+    "@clack/core": "^1.3.1",
+    "@clack/prompts": "^1.4.0",
+    "@kayvan/markdown-tree-parser": "^1.6.1",
+    "chalk": "^4.1.2",
+    "commander": "^14.0.0",
+    "csv-parse": "^6.1.0",
+    "glob": "^11.0.3",
+    "ignore": "^7.0.5",
+    "js-yaml": "^4.1.0",
+    "picocolors": "^1.1.1",
+    "semver": "^7.6.3",
+    "xml2js": "^0.6.2",
+    "yaml": "^2.7.0"
+  },
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install-from-github.ps1

@@ -0,0 +1,22 @@
+param(
+  [string]$Target = (Get-Location).Path,
+  [string]$Repo = $env:DRT_REPO
+)
+
+if (-not $Repo) {
+  $Repo = "https://github.com/your-org/drt-method.git"
+}
+
+$Tmp = Join-Path $env:TEMP ("drt-install-" + [guid]::NewGuid().ToString())
+New-Item -ItemType Directory -Path $Tmp | Out-Null
+
+try {
+  git clone --depth 1 $Repo (Join-Path $Tmp "drt-method")
+  Set-Location (Join-Path $Tmp "drt-method")
+  npm ci --omit=dev
+  node tools/installer/drt-cli.js install --directory $Target --modules drt --tools cursor --yes
+  Write-Host "DRT Method installed into $Target"
+}
+finally {
+  Remove-Item -Recurse -Force $Tmp -ErrorAction SilentlyContinue
+}

package/scripts/install-from-github.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="${DRT_REPO:-https://github.com/your-org/drt-method.git}"
+TARGET="${1:-.}"
+TARGET="$(cd "$TARGET" && pwd)"
+TMP="$(mktemp -d)"
+
+cleanup() { rm -rf "$TMP"; }
+trap cleanup EXIT
+
+git clone --depth 1 "$REPO" "$TMP/drt-method"
+cd "$TMP/drt-method"
+npm ci --omit=dev
+node tools/installer/drt-cli.js install --directory "$TARGET" --modules drt --tools cursor --yes
+
+echo "DRT Method installed into $TARGET"