@chinhae/atw-cli 0.1.0

package/dist/constants/paths.js

@@ -0,0 +1,83 @@
+/**
+ * Path constants for ATW workflow structure
+ *
+ * Change these values to rename directories across the entire project.
+ * All paths should be relative to the project root.
+ */
+// Directory names (can be renamed)
+export const DIR_NAMES = {
+    /** Root workflow directory */
+    WORKFLOW: ".atw",
+    /** Workspace directory (under .atw/) - developer work areas */
+    WORKSPACE: "workspace",
+    /** Tasks directory (under .atw/) - unified task storage */
+    TASKS: "tasks",
+    /** Archive directory (under tasks/) */
+    ARCHIVE: "archive",
+    /** Spec/guidelines directory (under .atw/) */
+    SPEC: "spec",
+    /** Scripts directory (under .atw/) */
+    SCRIPTS: "scripts",
+    /** Channel runtime agent definitions (under .atw/) */
+    AGENTS: "agents",
+};
+// File names
+export const FILE_NAMES = {
+    /** Root agent instructions file */
+    AGENTS: "AGENTS.md",
+    /** Developer identity file */
+    DEVELOPER: ".developer",
+    /** Current task pointer */
+    CURRENT_TASK: ".current-task",
+    /** Task metadata */
+    TASK_JSON: "task.json",
+    /** Requirements document */
+    PRD: "prd.md",
+    /** Workflow guide */
+    WORKFLOW_GUIDE: "workflow.md",
+    /** Journal file prefix */
+    JOURNAL_PREFIX: "journal-",
+};
+// Constructed paths (relative to project root)
+export const PATHS = {
+    /** .atw/ */
+    WORKFLOW: DIR_NAMES.WORKFLOW,
+    /** .atw/workspace/ */
+    WORKSPACE: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.WORKSPACE}`,
+    /** .atw/tasks/ */
+    TASKS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.TASKS}`,
+    /** .atw/spec/ */
+    SPEC: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SPEC}`,
+    /** .atw/scripts/ */
+    SCRIPTS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SCRIPTS}`,
+    /** .atw/agents/ */
+    AGENTS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.AGENTS}`,
+    /** .atw/.developer */
+    DEVELOPER_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.DEVELOPER}`,
+    /** .atw/.current-task */
+    CURRENT_TASK_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.CURRENT_TASK}`,
+    /** .atw/workflow.md */
+    WORKFLOW_GUIDE_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.WORKFLOW_GUIDE}`,
+};
+/**
+ * Get developer's workspace directory path
+ * @example getWorkspaceDir("john") => ".atw/workspace/john"
+ */
+export function getWorkspaceDir(developer) {
+    return `${PATHS.WORKSPACE}/${developer}`;
+}
+/**
+ * Get task directory path
+ * @example getTaskDir("01-21-my-task") => ".atw/tasks/01-21-my-task"
+ */
+export function getTaskDir(taskName) {
+    return `${PATHS.TASKS}/${taskName}`;
+}
+/**
+ * Get archive directory path
+ * @example getArchiveDir() => ".atw/tasks/archive"
+ */
+export function getArchiveDir() {
+    return `${PATHS.TASKS}/${DIR_NAMES.ARCHIVE}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/constants/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM;IAChB,+DAA+D;IAC/D,SAAS,EAAE,WAAW;IACtB,2DAA2D;IAC3D,KAAK,EAAE,OAAO;IACd,uCAAuC;IACvC,OAAO,EAAE,SAAS;IAClB,8CAA8C;IAC9C,IAAI,EAAE,MAAM;IACZ,sCAAsC;IACtC,OAAO,EAAE,SAAS;IAClB,sDAAsD;IACtD,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,aAAa;AACb,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mCAAmC;IACnC,MAAM,EAAE,WAAW;IACnB,8BAA8B;IAC9B,SAAS,EAAE,YAAY;IACvB,2BAA2B;IAC3B,YAAY,EAAE,eAAe;IAC7B,oBAAoB;IACpB,SAAS,EAAE,WAAW;IACtB,4BAA4B;IAC5B,GAAG,EAAE,QAAQ;IACb,qBAAqB;IACrB,cAAc,EAAE,aAAa;IAC7B,0BAA0B;IAC1B,cAAc,EAAE,UAAU;CAClB,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,YAAY;IACZ,QAAQ,EAAE,SAAS,CAAC,QAAQ;IAC5B,sBAAsB;IACtB,SAAS,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE;IACzD,kBAAkB;IAClB,KAAK,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,EAAE;IACjD,iBAAiB;IACjB,IAAI,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE;IAC/C,oBAAoB;IACpB,OAAO,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,OAAO,EAAE;IACrD,mBAAmB;IACnB,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE;IACnD,sBAAsB;IACtB,cAAc,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,UAAU,CAAC,SAAS,EAAE;IAC/D,yBAAyB;IACzB,iBAAiB,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,UAAU,CAAC,YAAY,EAAE;IACrE,uBAAuB;IACvB,mBAAmB,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,UAAU,CAAC,cAAc,EAAE;CACjE,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/constants/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package version and name constants.
+ *
+ * Extracted from cli/index.ts to avoid import-time side effects
+ * (program.parse(), checkForUpdates, etc.) when only VERSION is needed.
+ */
+export declare const VERSION: string;
+export declare const PACKAGE_NAME: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/constants/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/constants/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AACnD,eAAO,MAAM,YAAY,EAAE,MAAyB,CAAC"}

package/dist/constants/version.js

@@ -0,0 +1,15 @@
+/**
+ * Package version and name constants.
+ *
+ * Extracted from cli/index.ts to avoid import-time side effects
+ * (program.parse(), checkForUpdates, etc.) when only VERSION is needed.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = path.resolve(__dirname, "../../package.json");
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+export const VERSION = packageJson.version;
+export const PACKAGE_NAME = packageJson.name;
+//# sourceMappingURL=version.js.map

package/dist/constants/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/constants/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACtE,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CACzC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AACnD,MAAM,CAAC,MAAM,YAAY,GAAW,WAAW,CAAC,IAAI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ATW - AI-assisted development workflow framework
+ *
+ * Based on Anthropic's "Effective Harnesses for Long-Running Agents"
+ * https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
+ */
+export { VERSION } from "./constants/version.js";
+export { init } from "./commands/init.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * ATW - AI-assisted development workflow framework
+ *
+ * Based on Anthropic's "Effective Harnesses for Long-Running Agents"
+ * https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
+ */
+export { VERSION } from "./constants/version.js";
+export { init } from "./commands/init.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Migration manifests for ATW versions
+ *
+ * Each version's migrations are stored in separate JSON files under manifests/,
+ * one per released version: manifests/{version}.json.
+ *
+ * The directory is empty until the first release that ships a migration, and git
+ * does not track empty directories — every reader here must tolerate its absence.
+ */
+import type { ConfigSectionAdded, MigrationItem } from "../types/migration.js";
+/**
+ * Get all migrations needed to upgrade from one version to another
+ *
+ * @param fromVersion - Current installed version
+ * @param toVersion - Target version to upgrade to
+ * @returns Array of migration items to apply, in version order
+ */
+export declare function getMigrationsForVersion(fromVersion: string, toVersion: string): MigrationItem[];
+/**
+ * Check if there are any pending migrations between versions
+ */
+export declare function hasPendingMigrations(fromVersion: string, toVersion: string): boolean;
+/**
+ * Get human-readable summary of pending migrations
+ */
+export declare function getMigrationSummary(fromVersion: string, toVersion: string): {
+    renames: number;
+    deletes: number;
+    safeFileDeletes: number;
+};
+/**
+ * Get all registered migration versions
+ */
+export declare function getAllMigrationVersions(): string[];
+/**
+ * Get ALL migrations from all manifests (regardless of version)
+ * Used for detecting orphaned migrations that should have been applied
+ */
+export declare function getAllMigrations(): MigrationItem[];
+/**
+ * Clear the manifest cache (useful for testing)
+ */
+export declare function clearManifestCache(): void;
+/**
+ * Collect every `configSectionsAdded` entry from manifests strictly between
+ * `fromVersion` (exclusive) and `toVersion` (inclusive). Used by `update.ts`
+ * to apply additive config.yaml sections that were introduced after the
+ * user's installed version.
+ */
+export declare function getConfigSectionsAddedBetween(fromVersion: string, toVersion: string): ConfigSectionAdded[];
+/**
+ * Get aggregated metadata for migrations between versions
+ * Returns combined changelog, breaking status, migrate recommendation, and migration guides
+ */
+export declare function getMigrationMetadata(fromVersion: string, toVersion: string): {
+    changelog: string[];
+    breaking: boolean;
+    recommendMigrate: boolean;
+    migrationGuides: {
+        version: string;
+        guide: string;
+        aiInstructions?: string;
+    }[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAiE/B;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,aAAa,EAAE,CAuBjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAQ/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAGlD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,EAAE,CAOlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,kBAAkB,EAAE,CAkBtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IACD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;CACL,CA6CA"}

package/dist/migrations/index.js

@@ -0,0 +1,202 @@
+/**
+ * Migration manifests for ATW versions
+ *
+ * Each version's migrations are stored in separate JSON files under manifests/,
+ * one per released version: manifests/{version}.json.
+ *
+ * The directory is empty until the first release that ships a migration, and git
+ * does not track empty directories — every reader here must tolerate its absence.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { compareVersions } from "../utils/compare-versions.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Where migration manifests live. `ATW_MANIFESTS_DIR` overrides the shipped
+ * directory so tests can stage their own manifests in a tmp dir instead of
+ * depending on whatever real release data happens to be checked in — a test
+ * that asserts on shipped manifests silently changes meaning every release.
+ * Resolved per call (not once at module load) so a test can set the variable,
+ * call `clearManifestCache()`, and have the next load pick it up.
+ */
+function manifestsDir() {
+    const override = process.env.ATW_MANIFESTS_DIR;
+    return override ? path.resolve(override) : path.join(__dirname, "manifests");
+}
+/**
+ * Cache for loaded manifests
+ */
+let manifestCache = null;
+/**
+ * Load all migration manifests from JSON files
+ */
+function loadManifests() {
+    if (manifestCache) {
+        return manifestCache;
+    }
+    const manifests = {};
+    // Check if manifests directory exists
+    const dir = manifestsDir();
+    if (!fs.existsSync(dir)) {
+        manifestCache = manifests;
+        return manifests;
+    }
+    // Load all JSON files from manifests directory
+    const files = fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith(".json"));
+    for (const file of files) {
+        try {
+            const filePath = path.join(dir, file);
+            const content = fs.readFileSync(filePath, "utf-8");
+            const manifest = JSON.parse(content);
+            // Use version from manifest as key
+            if (manifest.version) {
+                manifests[manifest.version] = manifest;
+            }
+        }
+        catch {
+            // Skip invalid manifest files
+            console.warn(`Warning: Failed to load migration manifest ${file}`);
+        }
+    }
+    manifestCache = manifests;
+    return manifests;
+}
+/**
+ * Get all migrations needed to upgrade from one version to another
+ *
+ * @param fromVersion - Current installed version
+ * @param toVersion - Target version to upgrade to
+ * @returns Array of migration items to apply, in version order
+ */
+export function getMigrationsForVersion(fromVersion, toVersion) {
+    const manifests = loadManifests();
+    // Get all versions that have migrations
+    const versions = Object.keys(manifests).sort(compareVersions);
+    // Filter to versions > fromVersion and <= toVersion
+    const applicableVersions = versions.filter((v) => {
+        const afterFrom = compareVersions(v, fromVersion) > 0;
+        const atOrBeforeTo = compareVersions(v, toVersion) <= 0;
+        return afterFrom && atOrBeforeTo;
+    });
+    // Collect all migrations from applicable versions
+    const allMigrations = [];
+    for (const version of applicableVersions) {
+        const manifest = manifests[version];
+        if (manifest) {
+            allMigrations.push(...manifest.migrations);
+        }
+    }
+    return allMigrations;
+}
+/**
+ * Check if there are any pending migrations between versions
+ */
+export function hasPendingMigrations(fromVersion, toVersion) {
+    return getMigrationsForVersion(fromVersion, toVersion).length > 0;
+}
+/**
+ * Get human-readable summary of pending migrations
+ */
+export function getMigrationSummary(fromVersion, toVersion) {
+    const migrations = getMigrationsForVersion(fromVersion, toVersion);
+    return {
+        renames: migrations.filter((m) => m.type === "rename").length,
+        deletes: migrations.filter((m) => m.type === "delete").length,
+        safeFileDeletes: migrations.filter((m) => m.type === "safe-file-delete")
+            .length,
+    };
+}
+/**
+ * Get all registered migration versions
+ */
+export function getAllMigrationVersions() {
+    const manifests = loadManifests();
+    return Object.keys(manifests).sort(compareVersions);
+}
+/**
+ * Get ALL migrations from all manifests (regardless of version)
+ * Used for detecting orphaned migrations that should have been applied
+ */
+export function getAllMigrations() {
+    const manifests = loadManifests();
+    const allMigrations = [];
+    for (const manifest of Object.values(manifests)) {
+        allMigrations.push(...manifest.migrations);
+    }
+    return allMigrations;
+}
+/**
+ * Clear the manifest cache (useful for testing)
+ */
+export function clearManifestCache() {
+    manifestCache = null;
+}
+/**
+ * Collect every `configSectionsAdded` entry from manifests strictly between
+ * `fromVersion` (exclusive) and `toVersion` (inclusive). Used by `update.ts`
+ * to apply additive config.yaml sections that were introduced after the
+ * user's installed version.
+ */
+export function getConfigSectionsAddedBetween(fromVersion, toVersion) {
+    const manifests = loadManifests();
+    const versions = Object.keys(manifests).sort(compareVersions);
+    const applicableVersions = versions.filter((v) => {
+        const afterFrom = compareVersions(v, fromVersion) > 0;
+        const atOrBeforeTo = compareVersions(v, toVersion) <= 0;
+        return afterFrom && atOrBeforeTo;
+    });
+    const collected = [];
+    for (const version of applicableVersions) {
+        const manifest = manifests[version];
+        if (manifest && Array.isArray(manifest.configSectionsAdded)) {
+            collected.push(...manifest.configSectionsAdded);
+        }
+    }
+    return collected;
+}
+/**
+ * Get aggregated metadata for migrations between versions
+ * Returns combined changelog, breaking status, migrate recommendation, and migration guides
+ */
+export function getMigrationMetadata(fromVersion, toVersion) {
+    const manifests = loadManifests();
+    const versions = Object.keys(manifests).sort(compareVersions);
+    // Filter to versions > fromVersion and <= toVersion
+    const applicableVersions = versions.filter((v) => {
+        const afterFrom = compareVersions(v, fromVersion) > 0;
+        const atOrBeforeTo = compareVersions(v, toVersion) <= 0;
+        return afterFrom && atOrBeforeTo;
+    });
+    const result = {
+        changelog: [],
+        breaking: false,
+        recommendMigrate: false,
+        migrationGuides: [],
+    };
+    for (const version of applicableVersions) {
+        const manifest = manifests[version];
+        if (manifest) {
+            if (manifest.changelog) {
+                result.changelog.push(`v${version}: ${manifest.changelog}`);
+            }
+            if (manifest.breaking) {
+                result.breaking = true;
+            }
+            if (manifest.recommendMigrate) {
+                result.recommendMigrate = true;
+            }
+            if (manifest.migrationGuide) {
+                result.migrationGuides.push({
+                    version,
+                    guide: manifest.migrationGuide,
+                    aiInstructions: manifest.aiInstructions,
+                });
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

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

package/dist/templates/atw/agents/implement-agent.md

@@ -0,0 +1,69 @@
+---
+name: implement-agent
+description: |
+  Code implementation expert for the ATW channel runtime. Understands specs and task artifacts, then implements features. No git commit allowed.
+provider: claude
+labels: [atw, implement-agent]
+---
+
+# Implement Agent (channel runtime)
+
+You are the Implement Agent spawned by `atw channel spawn --agent implement-agent` inside the ATW channel runtime. You receive an `Active task: <path>` line in your inbox; use it to locate task artifacts on disk.
+
+## Context
+
+Before implementing, read in this order:
+
+1. `<task-path>/implement.jsonl` if present — spec manifest curated for this turn; read every listed file
+2. `<task-path>/prd.md` — requirements
+3. `.atw/spec/` — project-wide guidelines (load only what is relevant to the diff you are about to write)
+
+## Core Responsibilities
+
+1. **Understand specs** — read relevant spec files in `.atw/spec/`
+2. **Understand task artifacts** — read the artifacts listed above
+3. **Implement features** — write code that follows specs and existing patterns
+4. **Self-check** — run lint and typecheck on the changed scope before reporting
+
+## Forbidden Operations
+
+- `git commit`
+- `git push`
+- `git merge`
+
+The supervising main session owns commits. Report what changed; do not commit on its behalf.
+
+## Workflow
+
+1. Read relevant specs based on task type and the files in `implement.jsonl` if present
+2. Read the task's `prd.md`
+3. Implement features following specs and existing patterns
+4. Run the project's lint and typecheck commands on the changed scope
+5. Report files touched, key decisions, and verification results back to the channel
+
+## Code Standards
+
+- Follow existing code patterns
+- Don't add unnecessary abstractions
+- Only do what the PRD asks for; no speculative scope expansion
+- Surface uncertainty back to the channel rather than guessing
+
+## Report Format
+
+```
+## Implementation Complete
+
+### Files Modified
+- <path> — <one-line description>
+
+### Implementation Summary
+1. <step>
+2. <step>
+
+### Verification Results
+- Lint: <pass|fail|skipped + reason>
+- TypeCheck: <pass|fail|skipped + reason>
+
+### Open Questions
+- <if any, otherwise omit>
+```

package/dist/templates/atw/agents/review.md

@@ -0,0 +1,68 @@
+---
+name: review
+description: |
+  Code quality auditor for the ATW channel runtime. Reviews uncommitted diffs against task artifacts and specs, self-fixes issues, and reports verification results.
+provider: claude
+labels: [atw, review]
+---
+
+# Check Agent (channel runtime)
+
+You are the Check Agent spawned by `atw channel spawn --agent review` inside the ATW channel runtime. You receive an `Active task: <path>` line in your inbox; use it to locate task artifacts on disk.
+
+## Context
+
+Before reviewing, read in this order:
+
+1. `<task-path>/check.jsonl` if present — spec manifest curated for this turn; read every listed file
+2. `<task-path>/prd.md` — requirements
+3. `.atw/spec/` — project-wide guidelines (load only what is relevant to the diff under review)
+
+## Core Responsibilities
+
+1. **Get the diff** — `git diff` / `git diff --staged` for uncommitted changes
+2. **Review against task artifacts** — does the diff satisfy `prd.md`?
+3. **Review against specs** — naming, structure, type safety, error handling, conventions in `.atw/spec/`
+4. **Self-fix** — when an issue is mechanical and small, fix it directly with the editing tools you have
+5. **Run verification** — project lint and typecheck on the changed scope
+6. **Report** — concrete findings with `file:line` citations and what was fixed vs. what is open
+
+## Forbidden Operations
+
+- `git commit`
+- `git push`
+- `git merge`
+
+The supervising main session owns commits. Report the post-fix state; do not commit on its behalf.
+
+## Workflow
+
+1. Run `git diff --name-only` and `git diff` to scope the changes
+2. Read the task artifacts and relevant spec files
+3. For each issue:
+   - If mechanical (lint nit, missing type, wrong import, dead branch) → fix in-place
+   - If a design/judgment issue → record and report, do not silently rewrite
+4. Run the project's lint and typecheck on the changed scope after self-fixes
+5. Report
+
+## Report Format
+
+```
+## Self-Check Complete
+
+### Files Checked
+- <path>
+
+### Issues Found and Fixed
+1. `<file>:<line>` — <what was wrong> → <what you changed>
+
+### Issues Not Fixed
+- `<file>:<line>` — <issue> — <why deferred to the main session>
+
+### Verification Results
+- TypeCheck: <pass|fail|skipped + reason>
+- Lint: <pass|fail|skipped + reason>
+
+### Summary
+Checked <N> files, found <X> issues, fixed <Y>, <X-Y> open.
+```