@yarkingulacti/agentic-scaffold 0.7.0 → 0.8.0

package/README.md

@@ -64,34 +64,44 @@ npx @yarkingulacti/agentic-scaffold --skip-skills --skip-scripts --skip-hooks
 
 # Pre-configure values
 npx @yarkingulacti/agentic-scaffold --project-name "my-app" --issue-tracker github
+
+# Remove all scaffolded files (asks for confirmation)
+npx @yarkingulacti/agentic-scaffold un
+
+# Remove without confirmation
+npx @yarkingulacti/agentic-scaffold un --force
 ```
 
 ## What you get
 
 ```
 project/
-├── AGENTS.md                 # Agent config (entry point for AI agents)
-├── CLAUDE.md                 # Mirror of AGENTS.md
-├── BUSINESS_LOGIC.md         # Shell — fill with your domain
-├── .gitignore
-├── docs/
-│   ├── CODING_PRINCIPLES.md  # Operating rules for code
-│   ├── adr/TEMPLATE.md       # Architecture Decision Record template
-│   ├── agents/
-│   │   ├── domain.md         # How to consume domain docs
-│   │   ├── session-close.md  # Post-coding session workflow
-│   │   ├── issue-tracker.md  # Issue tracker conventions
-│   │   └── triage-labels.md  # Triage status vocabulary
-│   ├── context/
-│   │   ├── INDEX.md          # Section index for CONTEXT.md
-│   │   └── glossary.md       # Ubiquitous language glossary
-│   ├── engineering/README.md
-│   └── product/README.md
-├── .agents/skills/           # Agent skill definitions (21 skills)
-├── .agents/hooks/            # Pre/post lifecycle hooks for agent workflows
-├── scripts/                  # Markdown memory indexing pipeline
-├── .scratchpad/              # Local detailed planning
-└── .history/                 # Shipped work summaries
+├── AGENTS.md -> .agentic-scaffold/AGENTS.md   # Symlink entry point
+├── CLAUDE.md -> .agentic-scaffold/CLAUDE.md   # Symlink entry point
+└── .agentic-scaffold/                          # Single wrapper directory
+    ├── AGENTS.md                 # Agent config (entry point for AI agents)
+    ├── CLAUDE.md                 # Mirror of AGENTS.md
+    ├── BUSINESS_LOGIC.md         # Shell — fill with your domain
+    ├── .gitignore
+    ├── docs/
+    │   ├── CODING_PRINCIPLES.md  # Operating rules for code
+    │   ├── adr/TEMPLATE.md       # Architecture Decision Record template
+    │   ├── agents/
+    │   │   ├── domain.md         # How to consume domain docs
+    │   │   ├── session-close.md  # Post-coding session workflow
+    │   │   ├── issue-tracker.md  # Issue tracker conventions
+    │   │   └── triage-labels.md  # Triage status vocabulary
+    │   ├── context/
+    │   │   ├── INDEX.md          # Section index for CONTEXT.md
+    │   │   └── glossary.md       # Ubiquitous language glossary
+    │   ├── engineering/README.md
+    │   └── product/README.md
+    ├── .agents/
+    │   ├── skills/               # Agent skill definitions (22 skills)
+    │   └── hooks/                # Pre/post lifecycle hooks
+    ├── scripts/                  # Markdown memory indexing pipeline
+    ├── .scratchpad/              # Local detailed planning
+    └── .history/                 # Shipped work summaries
 ```
 
 ## Auto-detection
@@ -126,6 +136,19 @@ CLI flags.
 - **`--skip-hooks` flag** — skip the hooks component group.
 - **98 tests** — detection, scaffolding, CLI, and hooks tested end-to-end.
 
+## New in v0.7.1
+
+- **`unscaffold` command** — `npx @yarkingulacti/agentic-scaffold un` removes all scaffolded files and symlinks interactively; `--force` skips confirmation.
+- **`next` skill** — new agent skill for planning and executing the next development step.
+- **Template refinements** — improved task/issue descriptions, clearer checklists, refined AGENTS.md/CLAUDE.md formatting across all templates.
+- **164 tests** — detection, scaffolding, CLI, unscaffold, and all hooks tested end-to-end.
+
+## New in v0.6
+
+- **Interactive mode redesign** — shows detected project profile before prompts, pre-fills prompts with detected values, and per-file conflict resolver that asks before overwriting existing files.
+- **MEMORY.md golden rules** — feature branches mandatory for new features, every release gets a version tag.
+- **Per-file conflict resolution** — `askOverwrite()` prompt lets you decide for each existing file during scaffolding.
+
 ## New in v0.5
 
 - **`fill-docs` skill** — new agent skill that interviews you to complete placeholder content in BUSINESS_LOGIC.md, glossary, and other scaffolded docs.
@@ -154,12 +177,26 @@ CLI flags.
 
 ## After scaffolding
 
-1. Fill in `BUSINESS_LOGIC.md` with your product domain.
+1. Fill in `.agentic-scaffold/BUSINESS_LOGIC.md` with your product domain.
 2. Run `npm install` / `pnpm install` for your project's actual dependencies.
 3. `python3 -m venv .venv && pip install sqlite-vec` if you want vector memory.
-4. Install the skills in your AI tool (e.g. opencode) — each `.agents/skills/*/SKILL.md` is self-contained.
-5. Customize `docs/agents/triage-labels.md` to match your tracker's vocabulary.
-6. Use the `fill-docs` skill (`.agents/skills/fill-docs/SKILL.md`) to complete scaffolded documentation.
+4. Install the skills in your AI tool (e.g. opencode) — each `.agentic-scaffold/.agents/skills/*/SKILL.md` is self-contained.
+5. Customize `.agentic-scaffold/docs/agents/triage-labels.md` to match your tracker's vocabulary.
+6. Use the `fill-docs` skill (`.agentic-scaffold/.agents/skills/fill-docs/SKILL.md`) to complete scaffolded documentation.
+
+## Unscaffold
+
+Remove all scaffolded files in one command:
+
+```bash
+# Interactive (asks for confirmation)
+npx @yarkingulacti/agentic-scaffold un
+
+# Non-interactive
+npx @yarkingulacti/agentic-scaffold un --force
+```
+
+This removes the entire `.agentic-scaffold/` directory and the root-level symlinks (AGENTS.md, CLAUDE.md). Your project files are left untouched.
 
 ## Open source
 

package/dist/bin/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { scaffold } from "../src/scaffold.js";
+import { unscaffold } from "../src/unscaffold.js";
+function scaffoldBuilder(y) {
+    return y
+        .epilogue("Tiers:\n" +
+        "  Zero-config   Run with no flags — auto-detect project, scaffold only\n" +
+        "                what's missing. Never overwrites existing files.\n" +
+        "  Flag mode     Override auto-detection with --package-manager,\n" +
+        "                --ci-provider, --ai-tools, etc. Add --force to overwrite.\n" +
+        "  Interactive   Run with -i / --interactive for step-by-step prompts.")
+        .example("$0", "Zero-config: auto-detect and scaffold missing files")
+        .example("$0 --force", "Force overwrite existing files")
+        .example("$0 --ci-provider github", "Override auto-detected CI provider")
+        .example("$0 --ai-tools opencode,cursor", "Generate configs for specific AI tools")
+        .example("$0 -i", "Interactive mode with prompts")
+        .option("interactive", {
+        alias: "i",
+        type: "boolean",
+        description: "Run in interactive mode with prompts",
+        default: false,
+    })
+        .option("target", {
+        alias: "t",
+        type: "string",
+        description: "Target directory (default: current working directory)",
+        default: process.cwd(),
+    })
+        .option("only", {
+        type: "string",
+        description: "Comma-separated component groups to include: docs,scripts,skills,all",
+        default: "all",
+    })
+        .option("skip-skills", {
+        type: "boolean",
+        description: "Skip agent skill definitions",
+    })
+        .option("skip-hooks", {
+        type: "boolean",
+        description: "Skip agent lifecycle hook templates",
+    })
+        .option("skip-scripts", {
+        type: "boolean",
+        description: "Skip memory scripts",
+        default: false,
+    })
+        .option("skip-docs", {
+        type: "boolean",
+        description: "Skip docs folder",
+        default: false,
+    })
+        .option("project-name", {
+        type: "string",
+        description: "Project name (used in generated files)",
+    })
+        .option("issue-tracker", {
+        type: "string",
+        choices: ["linear", "github", "both"],
+        description: "Issue tracker type",
+    })
+        .option("force", {
+        alias: "f",
+        type: "boolean",
+        description: "Overwrite existing files",
+        default: false,
+    })
+        .option("package-manager", {
+        type: "string",
+        choices: ["npm", "yarn", "pnpm", "pip", "poetry", "go-mod", "cargo"],
+        description: "Package manager (overrides auto-detection)",
+    })
+        .option("ci-provider", {
+        type: "string",
+        choices: ["github", "gitlab", "circleci"],
+        description: "CI provider (overrides auto-detection)",
+    })
+        .option("ai-tools", {
+        type: "string",
+        description: "Comma-separated AI tools to configure: opencode,cursor,copilot",
+    })
+        .option("script-language", {
+        type: "string",
+        choices: ["python", "node", "docker"],
+        description: "Memory script language (overrides auto-detection)",
+    });
+}
+function unBuilder(y) {
+    return y
+        .option("target", {
+        alias: "t",
+        type: "string",
+        description: "Target directory (default: current working directory)",
+        default: process.cwd(),
+    })
+        .option("force", {
+        alias: "f",
+        type: "boolean",
+        description: "Remove without confirmation",
+        default: false,
+    });
+}
+const _argv = yargs(hideBin(process.argv))
+    .command(["$0", "scaffold"], "Scaffold agentic configuration into a project", scaffoldBuilder, (argv) => scaffold(argv))
+    .command("un", "Remove scaffolded files from a project", unBuilder, (argv) => unscaffold(argv))
+    .demandCommand(1, "Use --help to see available commands")
+    .help()
+    .parse();
+_argv;
+//# sourceMappingURL=index.js.map

package/dist/bin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../bin/index.ts"],"names":[],"mappings":"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"}

package/dist/src/config.d.ts

@@ -0,0 +1,70 @@
+export declare const DEFAULTS: {
+    projectDescription: string;
+    issueTracker: string;
+    scriptLanguage: string;
+};
+export interface ScaffoldArgs {
+    target?: string;
+    projectName?: string;
+    projectDescription?: string;
+    issueTracker?: string;
+    packageManager?: string;
+    ciProvider?: string;
+    aiTools?: string;
+    scriptLanguage?: string;
+    force?: boolean;
+    interactive?: boolean;
+    only?: string;
+    skipDocs?: boolean;
+    skipSkills?: boolean;
+    skipScripts?: boolean;
+    skipHooks?: boolean;
+}
+export interface ScaffoldConfig {
+    target: string;
+    scaffoldDir: string;
+    projectName: string;
+    projectDescription: string;
+    languages: string[];
+    issueTracker: string;
+    packageManager: string | null;
+    ciProvider: string | null;
+    aiTools: string[];
+    scriptLanguage: string;
+    force: boolean;
+    interactive: boolean;
+    include: Set<string>;
+}
+export interface TrackerDoc {
+    name: string;
+    description: string;
+    trackerDoc: string;
+    short: string;
+    statusTable: string;
+    envFile: string;
+    envTemplate: string;
+}
+export interface HandlebarsData {
+    projectName: string;
+    projectDescription: string;
+    scriptsDir: string;
+    issueTrackerName: string;
+    issueTrackerDescription: string;
+    issueTrackerShort: string;
+    statusTable: string;
+    trackerDoc: string;
+    envFile: string;
+    envTemplate: string;
+    packageManager: string | null;
+    ciProvider: string | null;
+    scriptLanguage: string;
+    scaffoldVersion: string;
+    incompleteFiles: IncompleteFile[];
+}
+export interface IncompleteFile {
+    file: string;
+    sections: string;
+}
+export declare function resolveConfig(argv: ScaffoldArgs): ScaffoldConfig;
+export declare function buildHandlebars(config: ScaffoldConfig, version: string): HandlebarsData;
+export declare function buildIncompleteFiles(config: ScaffoldConfig): IncompleteFile[];

package/dist/src/config.js

@@ -0,0 +1,115 @@
+import { join } from "node:path";
+import { detectProjectProfile } from "./detect.js";
+export const DEFAULTS = {
+    projectDescription: "A project.",
+    issueTracker: "linear",
+    scriptLanguage: "python",
+};
+const ISSUE_TRACKER_DOCS = {
+    linear: {
+        name: "Linear",
+        description: "Short implementation records live in Linear. Local, detailed planning lives in `.agentic-scaffold/.scratchpad/<feature>/`. See `.agentic-scaffold/docs/agents/issue-tracker.md`.",
+        trackerDoc: "Linear",
+        short: "Short issue records live in Linear. Local detailed planning lives in `.agentic-scaffold/.scratchpad/`.",
+        statusTable: [
+            "| Label | Status string | Meaning |",
+            "|-------|--------------|---------|",
+            "| needs-triage | `needs-triage` | Maintainer needs to evaluate this issue |",
+            "| needs-info   | `needs-info`   | Waiting on reporter for more information |",
+            "| ready-for-agent | `ready-for-agent` | Fully specified, ready for an AI agent |",
+            "| ready-for-human | `ready-for-human` | Requires human implementation |",
+            "| wontfix      | `wontfix`      | Will not be actioned |",
+        ].join("\n"),
+        envFile: ".env.linear\n.env.linear.local",
+        envTemplate: "LINEAR_TEAM_KEY=\nLINEAR_PROJECT_ID=",
+    },
+    github: {
+        name: "GitHub Issues",
+        description: "Short implementation records live in GitHub Issues. Local, detailed planning lives in `.agentic-scaffold/.scratchpad/<feature>/`. See `.agentic-scaffold/docs/agents/issue-tracker.md`.",
+        trackerDoc: "GitHub Issues",
+        short: "Short issue records live in GitHub Issues. Local detailed planning lives in `.scratchpad/`.",
+        statusTable: [
+            "| Label | Meaning |",
+            "|-------|---------|",
+            "| `needs-triage` | Maintainer needs to evaluate this issue |",
+            "| `needs-info`   | Waiting on reporter for more information |",
+            "| `ready-for-agent` | Fully specified, ready for an AI agent |",
+            "| `ready-for-human` | Requires human implementation |",
+            "| `wontfix`      | Will not be actioned |",
+        ].join("\n"),
+        envFile: "",
+        envTemplate: "",
+    },
+};
+function resolveIncludes(argv) {
+    if (argv.only && argv.only !== "all") {
+        return new Set(argv.only.split(",").map((s) => s.trim()));
+    }
+    const set = new Set(["docs", "scripts", "skills", "hooks"]);
+    if (argv.skipDocs)
+        set.delete("docs");
+    if (argv.skipScripts)
+        set.delete("scripts");
+    if (argv.skipSkills)
+        set.delete("skills");
+    if (argv.skipHooks)
+        set.delete("hooks");
+    return set;
+}
+export function resolveConfig(argv) {
+    const target = argv.target || process.cwd();
+    const profile = detectProjectProfile(target);
+    return {
+        target,
+        scaffoldDir: join(target, ".agentic-scaffold"),
+        projectName: argv.projectName ?? profile.projectName ?? target.split("/").filter(Boolean).pop() ?? "project",
+        projectDescription: argv.projectDescription ?? DEFAULTS.projectDescription,
+        languages: profile.languages,
+        issueTracker: argv.issueTracker ?? profile.issueTracker ?? DEFAULTS.issueTracker,
+        packageManager: argv.packageManager ?? profile.packageManager ?? null,
+        ciProvider: argv.ciProvider ?? profile.ciProvider ?? null,
+        aiTools: argv.aiTools
+            ? argv.aiTools
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean)
+            : profile.aiTools,
+        scriptLanguage: argv.scriptLanguage ?? profile.scriptLanguage ?? DEFAULTS.scriptLanguage,
+        force: argv.force ?? false,
+        interactive: argv.interactive ?? false,
+        include: resolveIncludes(argv),
+    };
+}
+export function buildHandlebars(config, version) {
+    const tracker = ISSUE_TRACKER_DOCS[config.issueTracker] || ISSUE_TRACKER_DOCS.linear;
+    return {
+        projectName: config.projectName,
+        projectDescription: config.projectDescription,
+        scriptsDir: ".agentic-scaffold/scripts",
+        issueTrackerName: tracker.name,
+        issueTrackerDescription: tracker.description,
+        issueTrackerShort: tracker.short,
+        statusTable: tracker.statusTable,
+        trackerDoc: tracker.trackerDoc,
+        envFile: tracker.envFile,
+        envTemplate: tracker.envTemplate,
+        packageManager: config.packageManager,
+        ciProvider: config.ciProvider,
+        scriptLanguage: config.scriptLanguage,
+        scaffoldVersion: version,
+        incompleteFiles: buildIncompleteFiles(config),
+    };
+}
+export function buildIncompleteFiles(config) {
+    const files = [
+        {
+            file: ".agentic-scaffold/BUSINESS_LOGIC.md",
+            sections: "Core Domain Concepts, Non-Negotiable Rules, Architecture Decisions",
+        },
+    ];
+    if (config.include.has("docs")) {
+        files.push({ file: ".agentic-scaffold/docs/context/glossary.md", sections: "domain term definitions" }, { file: ".agentic-scaffold/docs/product/README.md", sections: "product spec descriptions" }, { file: ".agentic-scaffold/docs/engineering/README.md", sections: "implementation conventions" });
+    }
+    return files;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/detect.d.ts

@@ -0,0 +1,16 @@
+export interface ProjectProfile {
+    projectName: string;
+    languages: string[];
+    packageManager: string | null;
+    ciProvider: string | null;
+    aiTools: string[];
+    issueTracker: string | null;
+    scriptLanguage: string | null;
+    hasDockerfile: boolean;
+    hasEnvExample: boolean;
+    hasContributing: boolean;
+    hasChangelog: boolean;
+    hasApiDocs: boolean;
+    hasMigrations: boolean;
+}
+export declare function detectProjectProfile(targetDir: string): ProjectProfile;

package/dist/src/detect.js

@@ -0,0 +1,104 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function detectProjectProfile(targetDir) {
+    const projectName = targetDir.split("/").filter(Boolean).pop() || "project";
+    return {
+        projectName,
+        languages: detectLanguages(targetDir),
+        packageManager: detectPackageManager(targetDir),
+        ciProvider: detectCIProvider(targetDir),
+        aiTools: detectAITools(targetDir),
+        issueTracker: detectIssueTracker(targetDir),
+        scriptLanguage: detectScriptLanguage(targetDir),
+        hasDockerfile: existsSync(join(targetDir, "Dockerfile")),
+        hasEnvExample: existsSync(join(targetDir, ".env.example")),
+        hasContributing: existsSync(join(targetDir, "CONTRIBUTING.md")),
+        hasChangelog: existsSync(join(targetDir, "CHANGELOG.md")),
+        hasApiDocs: existsSync(join(targetDir, "docs", "api")),
+        hasMigrations: migrationDirs.some((dir) => existsSync(join(targetDir, dir))),
+    };
+}
+const migrationDirs = ["migrations", "db/migrations", "prisma/migrations", "alembic"];
+function detectLanguages(targetDir) {
+    const languages = [];
+    if (existsSync(join(targetDir, "package.json"))) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(targetDir, "package.json"), "utf-8"));
+            const deps = pkg.devDependencies;
+            const prodDeps = pkg.dependencies;
+            if (deps?.typescript || prodDeps?.typescript) {
+                languages.push("ts");
+            }
+            else {
+                languages.push("js");
+            }
+        }
+        catch {
+            languages.push("js");
+        }
+    }
+    if (existsSync(join(targetDir, "requirements.txt"))) {
+        languages.push("python");
+    }
+    if (existsSync(join(targetDir, "pyproject.toml"))) {
+        languages.push("python");
+    }
+    if (existsSync(join(targetDir, "go.mod"))) {
+        languages.push("go");
+    }
+    if (existsSync(join(targetDir, "Cargo.toml"))) {
+        languages.push("rust");
+    }
+    return languages;
+}
+function detectPackageManager(targetDir) {
+    if (existsSync(join(targetDir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(targetDir, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(targetDir, "package-lock.json")))
+        return "npm";
+    if (existsSync(join(targetDir, "poetry.lock")))
+        return "poetry";
+    if (existsSync(join(targetDir, "Pipfile.lock")))
+        return "pip";
+    return null;
+}
+function detectCIProvider(targetDir) {
+    if (existsSync(join(targetDir, ".github", "workflows")))
+        return "github";
+    if (existsSync(join(targetDir, ".gitlab-ci.yml")))
+        return "gitlab";
+    if (existsSync(join(targetDir, ".circleci", "config.yml")))
+        return "circleci";
+    return null;
+}
+function detectAITools(targetDir) {
+    const tools = [];
+    if (existsSync(join(targetDir, "opencode.json")))
+        tools.push("opencode");
+    if (existsSync(join(targetDir, ".cursorrules")))
+        tools.push("cursor");
+    if (existsSync(join(targetDir, ".copilot-instructions.md")))
+        tools.push("copilot");
+    if (existsSync(join(targetDir, ".windsurfrules")))
+        tools.push("windsurf");
+    if (existsSync(join(targetDir, ".clinerules")))
+        tools.push("cline");
+    return tools;
+}
+function detectIssueTracker(targetDir) {
+    if (existsSync(join(targetDir, ".github")))
+        return "github";
+    return null;
+}
+function detectScriptLanguage(targetDir) {
+    if (existsSync(join(targetDir, "package.json")))
+        return "node";
+    if (existsSync(join(targetDir, "requirements.txt")))
+        return "python";
+    if (existsSync(join(targetDir, "pyproject.toml")))
+        return "python";
+    return null;
+}
+//# sourceMappingURL=detect.js.map

package/dist/src/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/detect.ts"],"names":[],"mappings":"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"}

package/dist/src/fs-utils.d.ts

@@ -0,0 +1,14 @@
+export interface WriteOptions {
+    interactive?: boolean;
+    force?: boolean;
+    onProgress?: () => void;
+}
+export declare function write(targetPath: string, content: string, options?: WriteOptions): Promise<string>;
+export declare function copyFile(src: string, dest: string, options?: WriteOptions): Promise<string>;
+export declare function copyStaticDir(srcDir: string, destDir: string, options?: WriteOptions): Promise<string[]>;
+export declare function createSymlinks(target: string, _scaffoldDir: string): string[];
+export interface DirEntry {
+    name: string;
+    full: string;
+}
+export declare function walkDir(dir: string): DirEntry[];