sdd-cli 0.1.5 → 0.1.7

package/README.md

@@ -12,6 +12,12 @@ Build the foundation once, then lift everything else. The tool provides a durabl
 
 Mission and vision live in `docs/MISSION.md` and `docs/VISION.md`.
 
+Start with `docs/INDEX.md` for a full documentation map and `docs/STYLE.md` for formatting guidance.
+Contributing guidelines live in `docs/CONTRIBUTING.md`.
+Use the PR template in `.github/PULL_REQUEST_TEMPLATE.md`.
+Maintenance guidance lives in `docs/MAINTENANCE.md`.
+Install troubleshooting lives in `docs/TROUBLESHOOTING.md`.
+
 Deep process, commands, interactions, and diagrams live in:
 - `docs/PROCESS.md`
 - `docs/COMMANDS.md`
@@ -55,6 +61,10 @@ Examples and templates:
 - `examples/schemas/`
 - `examples/diagrams/`
 - `examples/packs/`
+- `examples/README.md`
+- `templates/README.md`
+- `schemas/README.md`
+- `flows/README.md`
 - `templates/`
 - `schemas/`
 

package/dist/cli.js

@@ -46,6 +46,7 @@ const route_1 = require("./commands/route");
 const doctor_1 = require("./commands/doctor");
 const paths_1 = require("./paths");
 const flags_1 = require("./context/flags");
+const prompt_1 = require("./ui/prompt");
 const program = new commander_1.Command();
 function getVersion() {
     try {
@@ -76,6 +77,9 @@ program.hook("preAction", (thisCommand, actionCommand) => {
         output: typeof opts.output === "string" ? opts.output : undefined
     });
 });
+program.hook("postAction", () => {
+    (0, prompt_1.closePrompt)();
+});
 program
     .command("hello")
     .description("Start an interactive session and route intent")

package/dist/commands/doctor.js

@@ -67,11 +67,6 @@ function runDoctor(projectName, reqId) {
         ];
         root = candidates.find((candidate) => fs_1.default.existsSync(candidate)) ?? root;
     }
-    const jsonFiles = collectJsonFiles(root);
-    if (jsonFiles.length === 0) {
-        console.log("No JSON artifacts found in workspace.");
-        return;
-    }
     let failures = 0;
     const promptResult = (0, validate_prompt_packs_1.validatePromptPacks)();
     if (!promptResult.valid) {
@@ -85,6 +80,10 @@ function runDoctor(projectName, reqId) {
         console.log("Template validation failed:");
         templateResult.errors.forEach((error) => console.log(`- ${error}`));
     }
+    const jsonFiles = collectJsonFiles(root);
+    if (jsonFiles.length === 0) {
+        console.log("No JSON artifacts found in workspace.");
+    }
     for (const filePath of jsonFiles) {
         const schema = inferSchema(filePath);
         if (!schema) {
@@ -101,9 +100,12 @@ function runDoctor(projectName, reqId) {
             console.log(`Valid: ${filePath}`);
         }
     }
-    if (failures === 0) {
+    if (failures === 0 && jsonFiles.length > 0) {
         console.log("All JSON artifacts are valid.");
     }
+    else if (failures === 0) {
+        console.log("Prompt packs and templates are valid.");
+    }
     else {
         console.log(`Validation failed for ${failures} artifact(s).`);
     }

package/dist/commands/hello.js

@@ -8,12 +8,30 @@ const prompt_packs_1 = require("../router/prompt-packs");
 const prompt_map_1 = require("../router/prompt-map");
 const req_create_1 = require("./req-create");
 const flags_1 = require("../context/flags");
+const route_1 = require("./route");
 async function runHello(input, runQuestions) {
-    const workspace = (0, index_1.getWorkspaceInfo)();
-    (0, index_1.ensureWorkspace)(workspace);
-    const projects = (0, index_1.listProjects)(workspace);
+    function loadWorkspace() {
+        const workspace = (0, index_1.getWorkspaceInfo)();
+        (0, index_1.ensureWorkspace)(workspace);
+        const projects = (0, index_1.listProjects)(workspace);
+        return { workspace, projects };
+    }
+    let { workspace, projects } = loadWorkspace();
     console.log("Hello from sdd-cli.");
     console.log(`Workspace: ${workspace.root}`);
+    const useWorkspace = await (0, prompt_1.confirm)("Use this workspace path? (y/n) ");
+    if (!useWorkspace) {
+        const nextPath = await (0, prompt_1.ask)("Workspace path to use (blank to exit): ");
+        if (!nextPath) {
+            console.log("Run again from the desired folder or pass --output <path>.");
+            return;
+        }
+        (0, flags_1.setFlags)({ output: nextPath });
+        const reloaded = loadWorkspace();
+        workspace = reloaded.workspace;
+        projects = reloaded.projects;
+        console.log(`Workspace updated: ${workspace.root}`);
+    }
     const flags = (0, flags_1.getFlags)();
     if (projects.length > 0) {
         console.log("Active projects:");
@@ -49,8 +67,15 @@ async function runHello(input, runQuestions) {
     }
     const intent = (0, intent_1.classifyIntent)(text);
     console.log(`Detected intent: ${intent.intent} -> ${intent.flow}`);
-    console.log("Next: run `sdd-cli route <your input>` to view details.");
-    if (runQuestions) {
+    const showRoute = await (0, prompt_1.confirm)("View route details now? (y/n) ");
+    if (showRoute) {
+        (0, route_1.runRoute)(text);
+    }
+    else {
+        console.log("Next: run `sdd-cli route <your input>` to view details.");
+    }
+    const shouldRunQuestions = runQuestions ?? (await (0, prompt_1.confirm)("Run prompt questions now? (y/n) "));
+    if (shouldRunQuestions) {
         const packs = (0, prompt_packs_1.loadPromptPacks)();
         const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
         const answers = {};
@@ -78,4 +103,9 @@ async function runHello(input, runQuestions) {
             }
         }
     }
+    else {
+        console.log("\nNext steps:");
+        console.log("- Run `sdd-cli route \"<your input>\"` to review the flow.");
+        console.log("- Run `sdd-cli req create` to draft a requirement.");
+    }
 }

package/dist/commands/req-export.js

@@ -37,7 +37,11 @@ async function runReqExport() {
     for (const entry of fs_1.default.readdirSync(sourceDir)) {
         const srcPath = path_1.default.join(sourceDir, entry);
         const destPath = path_1.default.join(targetDir, entry);
-        if (fs_1.default.statSync(srcPath).isFile()) {
+        const stat = fs_1.default.statSync(srcPath);
+        if (stat.isDirectory()) {
+            fs_1.default.cpSync(srcPath, destPath, { recursive: true });
+        }
+        else if (stat.isFile()) {
             fs_1.default.copyFileSync(srcPath, destPath);
         }
     }

package/dist/commands/req-finish.js

@@ -64,17 +64,6 @@ async function runReqFinish() {
             return;
         }
     }
-    const doneDir = path_1.default.join(project.root, "requirements", "done", reqId);
-    fs_1.default.mkdirSync(path_1.default.dirname(doneDir), { recursive: true });
-    fs_1.default.renameSync(requirementDir, doneDir);
-    (0, index_1.updateProjectStatus)(workspace, project.name, "done");
-    const requirementJsonPath = path_1.default.join(doneDir, "requirement.json");
-    if (fs_1.default.existsSync(requirementJsonPath)) {
-        const requirementJson = JSON.parse(fs_1.default.readFileSync(requirementJsonPath, "utf-8"));
-        requirementJson.status = "done";
-        requirementJson.updatedAt = new Date().toISOString();
-        fs_1.default.writeFileSync(requirementJsonPath, JSON.stringify(requirementJson, null, 2), "utf-8");
-    }
     const overview = await (0, prompt_1.ask)("Project overview (for README): ");
     const howToRun = await (0, prompt_1.ask)("How to run (for README): ");
     const archSummary = await (0, prompt_1.ask)("Architecture summary (for README): ");
@@ -110,26 +99,55 @@ async function runReqFinish() {
         readmeValidation.errors.forEach((error) => console.log(`- ${error}`));
         return;
     }
+    const sourceDir = requirementDir;
+    const sourceStatus = path_1.default.basename(path_1.default.dirname(sourceDir));
+    const doneDir = path_1.default.join(project.root, "requirements", "done", reqId);
     const projectRoot = project.root;
-    fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.md"), readmeRendered, "utf-8");
-    fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.json"), JSON.stringify(readmeJson, null, 2), "utf-8");
-    const decisionLog = path_1.default.join(doneDir, "decision-log");
-    if (fs_1.default.existsSync(decisionLog)) {
-        const archiveRoot = path_1.default.join(projectRoot, "decision-log", reqId);
-        fs_1.default.mkdirSync(path_1.default.dirname(archiveRoot), { recursive: true });
-        fs_1.default.renameSync(decisionLog, archiveRoot);
-    }
-    const progressLog = path_1.default.join(doneDir, "progress-log.md");
-    if (!fs_1.default.existsSync(progressLog)) {
-        fs_1.default.writeFileSync(progressLog, "# Progress Log\n\n", "utf-8");
+    let moved = false;
+    try {
+        if (sourceDir !== doneDir) {
+            fs_1.default.mkdirSync(path_1.default.dirname(doneDir), { recursive: true });
+            fs_1.default.renameSync(sourceDir, doneDir);
+            moved = true;
+        }
+        (0, index_1.updateProjectStatus)(workspace, project.name, "done");
+        const requirementJsonPath = path_1.default.join(doneDir, "requirement.json");
+        if (fs_1.default.existsSync(requirementJsonPath)) {
+            const requirementJson = JSON.parse(fs_1.default.readFileSync(requirementJsonPath, "utf-8"));
+            requirementJson.status = "done";
+            requirementJson.updatedAt = new Date().toISOString();
+            fs_1.default.writeFileSync(requirementJsonPath, JSON.stringify(requirementJson, null, 2), "utf-8");
+        }
+        fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.md"), readmeRendered, "utf-8");
+        fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.json"), JSON.stringify(readmeJson, null, 2), "utf-8");
+        const decisionLog = path_1.default.join(doneDir, "decision-log");
+        if (fs_1.default.existsSync(decisionLog)) {
+            const archiveRoot = path_1.default.join(projectRoot, "decision-log", reqId);
+            fs_1.default.mkdirSync(path_1.default.dirname(archiveRoot), { recursive: true });
+            fs_1.default.renameSync(decisionLog, archiveRoot);
+        }
+        const progressLog = path_1.default.join(doneDir, "progress-log.md");
+        if (!fs_1.default.existsSync(progressLog)) {
+            fs_1.default.writeFileSync(progressLog, "# Progress Log\n\n", "utf-8");
+        }
+        const logEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
+        fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
+        const changelog = path_1.default.join(doneDir, "changelog.md");
+        if (!fs_1.default.existsSync(changelog)) {
+            fs_1.default.writeFileSync(changelog, "# Changelog\n\n", "utf-8");
+        }
+        const changeEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
+        fs_1.default.appendFileSync(changelog, changeEntry, "utf-8");
     }
-    const logEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
-    fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
-    const changelog = path_1.default.join(doneDir, "changelog.md");
-    if (!fs_1.default.existsSync(changelog)) {
-        fs_1.default.writeFileSync(changelog, "# Changelog\n\n", "utf-8");
+    catch (error) {
+        if (moved && fs_1.default.existsSync(doneDir) && !fs_1.default.existsSync(sourceDir)) {
+            fs_1.default.renameSync(doneDir, sourceDir);
+        }
+        if (sourceStatus && sourceStatus !== "done") {
+            (0, index_1.updateProjectStatus)(workspace, project.name, sourceStatus);
+        }
+        console.log(`Failed to finish requirement: ${error.message}`);
+        return;
     }
-    const changeEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
-    fs_1.default.appendFileSync(changelog, changeEntry, "utf-8");
     console.log(`Moved requirement to ${doneDir}`);
 }

package/dist/commands/req-refine.js

@@ -143,6 +143,9 @@ async function runReqRefine() {
     const mdPath = reqPath.replace("requirement.json", "requirement.md");
     fs_1.default.writeFileSync(mdPath, rendered, "utf-8");
     const changelogPath = path_1.default.join(path_1.default.dirname(reqPath), "changelog.md");
+    if (!fs_1.default.existsSync(changelogPath)) {
+        fs_1.default.writeFileSync(changelogPath, "# Changelog\n\n", "utf-8");
+    }
     const logEntry = `\n- ${new Date().toISOString()} refined requirement ${updated.id}\n`;
     fs_1.default.appendFileSync(changelogPath, logEntry, "utf-8");
     if (flags.improve) {

package/dist/commands/req-report.js

@@ -14,8 +14,7 @@ const REQUIRED_FILES = [
     "technical-spec.json",
     "architecture.json",
     "test-plan.json",
-    "quality.json",
-    "project-readme.json"
+    "quality.json"
 ];
 async function runReqReport() {
     const projectName = await (0, prompt_1.askProjectName)();
@@ -48,5 +47,11 @@ async function runReqReport() {
         if (!exists)
             missing += 1;
     }
+    const projectReadmePath = path_1.default.join(project.root, "project-readme.json");
+    const projectReadmeExists = fs_1.default.existsSync(projectReadmePath);
+    console.log(`${projectReadmeExists ? "OK" : "MISSING"}: ../project-readme.json`);
+    if (!projectReadmeExists) {
+        missing += 1;
+    }
     console.log(`Missing files: ${missing}`);
 }

package/dist/context/flags.js

@@ -10,11 +10,21 @@ const flags = {
     output: undefined
 };
 function setFlags(next) {
-    flags.approve = Boolean(next.approve);
-    flags.improve = Boolean(next.improve);
-    flags.parallel = Boolean(next.parallel);
-    flags.project = typeof next.project === "string" ? next.project : undefined;
-    flags.output = typeof next.output === "string" ? next.output : undefined;
+    if ("approve" in next) {
+        flags.approve = Boolean(next.approve);
+    }
+    if ("improve" in next) {
+        flags.improve = Boolean(next.improve);
+    }
+    if ("parallel" in next) {
+        flags.parallel = Boolean(next.parallel);
+    }
+    if ("project" in next) {
+        flags.project = typeof next.project === "string" ? next.project : undefined;
+    }
+    if ("output" in next) {
+        flags.output = typeof next.output === "string" ? next.output : undefined;
+    }
 }
 function getFlags() {
     return { ...flags };

package/dist/templates/render.js

@@ -12,7 +12,10 @@ function loadTemplate(name) {
     const root = (0, paths_1.getRepoRoot)();
     const mdPath = path_1.default.join(root, "templates", `${name}.md`);
     const ymlPath = path_1.default.join(root, "templates", `${name}.yml`);
-    const filePath = fs_1.default.existsSync(mdPath) ? mdPath : ymlPath;
+    const filePath = fs_1.default.existsSync(mdPath) ? mdPath : fs_1.default.existsSync(ymlPath) ? ymlPath : null;
+    if (!filePath) {
+        throw new Error(`Template not found: ${name} (.md or .yml)`);
+    }
     return fs_1.default.readFileSync(filePath, "utf-8");
 }
 function renderTemplate(template, data) {

package/dist/ui/prompt.d.ts

@@ -1,3 +1,4 @@
+export declare function closePrompt(): void;
 export declare function ask(question: string): Promise<string>;
 export declare function askProjectName(prompt?: string): Promise<string>;
 export declare function confirm(question: string): Promise<boolean>;

package/dist/ui/prompt.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.closePrompt = closePrompt;
 exports.ask = ask;
 exports.askProjectName = askProjectName;
 exports.confirm = confirm;
@@ -10,31 +11,58 @@ const fs_1 = __importDefault(require("fs"));
 const readline_1 = __importDefault(require("readline"));
 const flags_1 = require("../context/flags");
 let queuedAnswers = null;
+let rl = null;
+function shouldUseQueuedAnswers() {
+    if (process.env.SDD_STDIN === "1") {
+        return true;
+    }
+    return !process.stdin.isTTY && !process.stdout.isTTY;
+}
 function getQueuedAnswers() {
     if (queuedAnswers) {
         return queuedAnswers;
     }
-    if (!process.stdin.isTTY) {
-        const raw = fs_1.default.readFileSync(0, "utf-8");
-        queuedAnswers = raw.split(/\r?\n/).filter((line) => line.length > 0);
-        return queuedAnswers;
+    if (shouldUseQueuedAnswers()) {
+        try {
+            const raw = fs_1.default.readFileSync(0, "utf-8");
+            queuedAnswers = raw.split(/\r?\n/).filter((line) => line.length > 0);
+            return queuedAnswers;
+        }
+        catch {
+            queuedAnswers = [];
+            return queuedAnswers;
+        }
     }
     queuedAnswers = [];
     return queuedAnswers;
 }
-const rl = readline_1.default.createInterface({
-    input: process.stdin,
-    output: process.stdout
-});
-process.on("exit", () => rl.close());
+function getInterface() {
+    if (rl) {
+        return rl;
+    }
+    rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return rl;
+}
+function closePrompt() {
+    if (!rl) {
+        return;
+    }
+    rl.close();
+    rl = null;
+}
+process.on("exit", () => closePrompt());
 function ask(question) {
-    if (!process.stdin.isTTY) {
+    if (shouldUseQueuedAnswers()) {
         const queue = getQueuedAnswers();
         const answer = queue.shift() ?? "";
         return Promise.resolve(answer.trim());
     }
     return new Promise((resolve) => {
-        rl.question(question, (answer) => {
+        const prompt = getInterface();
+        prompt.question(question, (answer) => {
             resolve(answer.trim());
         });
     });

package/dist/workspace/index.js

@@ -15,6 +15,22 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const flags_1 = require("../context/flags");
+function readJsonFile(filePath) {
+    try {
+        const raw = fs_1.default.readFileSync(filePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function readWorkspaceIndex(workspace) {
+    const parsed = readJsonFile(workspace.indexPath);
+    if (!parsed || !Array.isArray(parsed.projects)) {
+        return { projects: [] };
+    }
+    return { projects: parsed.projects };
+}
 function getWorkspaceInfo() {
     const flags = (0, flags_1.getFlags)();
     const root = flags.output
@@ -61,9 +77,8 @@ function listProjects(workspace) {
     if (!fs_1.default.existsSync(workspace.indexPath)) {
         return [];
     }
-    const raw = fs_1.default.readFileSync(workspace.indexPath, "utf-8");
-    const parsed = JSON.parse(raw);
-    return (parsed.projects ?? []).map((project) => ({
+    const parsed = readJsonFile(workspace.indexPath);
+    return (parsed?.projects ?? []).map((project) => ({
         name: project.name ?? "unknown",
         status: project.status ?? "unknown"
     }));
@@ -80,7 +95,20 @@ function ensureProject(workspace, name, domain) {
     const metadataPath = path_1.default.join(projectRoot, "metadata.json");
     let metadata;
     if (fs_1.default.existsSync(metadataPath)) {
-        metadata = JSON.parse(fs_1.default.readFileSync(metadataPath, "utf-8"));
+        const parsed = readJsonFile(metadataPath);
+        if (parsed) {
+            metadata = parsed;
+        }
+        else {
+            const now = new Date().toISOString();
+            metadata = {
+                name: project.name,
+                status: "backlog",
+                domain,
+                createdAt: now,
+                updatedAt: now
+            };
+        }
     }
     else {
         const now = new Date().toISOString();
@@ -93,8 +121,7 @@ function ensureProject(workspace, name, domain) {
         };
         fs_1.default.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
     }
-    const indexRaw = fs_1.default.readFileSync(workspace.indexPath, "utf-8");
-    const index = JSON.parse(indexRaw);
+    const index = readWorkspaceIndex(workspace);
     index.projects = index.projects ?? [];
     const existing = index.projects.find((entry) => entry.name === project.name);
     if (existing) {
@@ -112,8 +139,7 @@ function createProject(workspace, name, domain) {
 function updateProjectStatus(workspace, name, status) {
     ensureWorkspace(workspace);
     const project = getProjectInfo(workspace, name);
-    const indexRaw = fs_1.default.readFileSync(workspace.indexPath, "utf-8");
-    const index = JSON.parse(indexRaw);
+    const index = readWorkspaceIndex(workspace);
     index.projects = index.projects ?? [];
     const existing = index.projects.find((entry) => entry.name === project.name);
     if (existing) {
@@ -125,8 +151,8 @@ function updateProjectStatus(workspace, name, status) {
     fs_1.default.writeFileSync(workspace.indexPath, JSON.stringify(index, null, 2), "utf-8");
     const projectRoot = project.root;
     const metadataPath = path_1.default.join(projectRoot, "metadata.json");
-    if (fs_1.default.existsSync(metadataPath)) {
-        const metadata = JSON.parse(fs_1.default.readFileSync(metadataPath, "utf-8"));
+    const metadata = fs_1.default.existsSync(metadataPath) ? readJsonFile(metadataPath) : null;
+    if (metadata) {
         metadata.status = status;
         metadata.updatedAt = new Date().toISOString();
         fs_1.default.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");

package/flows/README.md

@@ -1,29 +1,3 @@
-# Flows (domain playbooks)
-
-These flows show how the tool should guide real users from discovery to completion.
-
-- `LAWYER.md`
-- `TEACHER.md`
-- `ADMISSIONS_ADMIN.md`
-- `STATE_ADMIN.md`
-- `TAXES_ADMIN.md`
-- `STUDENT_UNIVERSITY.md`
-- `DATA_SCIENTIST.md`
-- `PROGRAMMER.md`
-- `BUG_FIX.md`
-- `ECOMMERCE.md`
-- `RETAIL_STORE.md`
-- `COURT_SYSTEM.md`
-- `GRAPHIC_DESIGN.md`
-- `ART.md`
-- `HISTORY.md`
-- `SOCIOLOGY.md`
-- `ECONOMICS.md`
-- `PR_REVIEW.md`
-
-Each flow includes:
-- Discovery questions
-- Required artifacts
-- Risk and compliance notes
-- Acceptance criteria examples
-- Recommended outputs and handoff steps
+# Flows
+
+Domain playbooks used by the router and discovery flows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "SDD-first, AI-native CLI for end-to-end delivery.",
   "homepage": "https://github.com/jdsalasca/sdd-tool#readme",
   "repository": {
@@ -27,6 +27,7 @@
     "build": "tsc -p tsconfig.json",
     "start": "node dist/cli.js",
     "dev": "ts-node src/cli.ts",
+    "preinstall": "node scripts/preinstall.js",
     "pretest": "npm run build",
     "test": "node --test tests/*.test.js"
   },

package/router/README.md

@@ -1,23 +1,25 @@
-# Router scripts
-
-These scripts define intent detection and the step-by-step conversation for each flow.
-
-Each script includes:
-- Entry signals
-- Required questions
-- Required outputs
-- Gate checks
-- Suggested agent roles
-- Scripted Q/A tree with optional branches
-
-Available flows:
-- BUG_FIX
-- LEARN
-- SOFTWARE_FEATURE
-- DATA_SCIENCE
-- DESIGN
-- HUMANITIES
-- BUSINESS
-- LEGAL
-- PR_REVIEW
-- GENERIC
+# Router scripts
+
+These scripts define intent detection and the step-by-step conversation for each flow.
+
+See `flows/README.md` for the domain playbooks.
+
+Each script includes:
+- Entry signals
+- Required questions
+- Required outputs
+- Gate checks
+- Suggested agent roles
+- Scripted Q/A tree with optional branches
+
+Available flows:
+- BUG_FIX
+- LEARN
+- SOFTWARE_FEATURE
+- DATA_SCIENCE
+- DESIGN
+- HUMANITIES
+- BUSINESS
+- LEGAL
+- PR_REVIEW
+- GENERIC

package/schemas/README.md

@@ -0,0 +1,7 @@
+# Schemas
+
+JSON schemas for artifacts and workspace state.
+
+## Usage
+- Used by `sdd-cli doctor` and validators.
+- Keep schema filenames consistent with artifact names.

package/templates/README.md

@@ -0,0 +1,12 @@
+# Templates
+
+Markdown and YAML templates used to generate SDD artifacts.
+
+## Index
+- `templates/template-index.json` lists all templates and placeholders.
+- `templates/gate-index.json` lists gate prompt templates.
+- `templates/prompt-pack-index.json` lists prompt packs.
+
+## Rules
+- Keep placeholders aligned with `templates/validate` rules.
+- Use lowercase file names with dashes (`functional-spec.md`).