yet-another-agentic-workflow 0.2.0

package/README.md

@@ -0,0 +1,125 @@
+# Yet Another Agentic Workflow
+
+**Yet Another Agentic Workflow installs a small, composable engineering harness into the coding agents you already use.**
+
+## What is YAAW?
+
+YAAW configures Claude Code and OpenAI Codex with focused engineering skills. It does not replace your coding agent or require a separate workflow runtime. After setup, keep working in the agent you already use.
+
+YAAW follows two principles:
+
+> **Agents get judgment. Software gets enforcement.**
+
+> **YAAW installs the engineering environment. The coding agent does the work.**
+
+## Quick start
+
+From the repository you want to configure, run:
+
+```bash
+npx yet-another-agentic-workflow@latest init
+```
+
+Choose Claude Code, Codex, or both. The initializer discovers repository tooling, summarizes its plan, preserves existing instructions, installs provider-native skills, and records ownership metadata.
+
+For scripts and CI, bypass prompts explicitly:
+
+```bash
+npx yet-another-agentic-workflow@latest init --provider claude --provider codex --yes
+```
+
+## What gets installed
+
+Claude Code uses:
+
+```text
+CLAUDE.md
+.claude/skills/<skill>/SKILL.md
+```
+
+OpenAI Codex uses:
+
+```text
+AGENTS.md
+.agents/skills/<skill>/SKILL.md
+```
+
+YAAW records installed version, selected providers, and generated-file hashes in:
+
+```text
+.yaaw/install.json
+```
+
+Skills come from the npm package. A project does not need a duplicate canonical `.yaaw/skills/` tree.
+
+## Supported coding agents
+
+| Provider | Instruction file | Skills directory |
+| --- | --- | --- |
+| Claude Code | `CLAUDE.md` | `.claude/skills/` |
+| OpenAI Codex | `AGENTS.md` | `.agents/skills/` |
+
+Provider definitions live behind a registry so another native integration can be added without rewriting the installer.
+
+## Engineering skills
+
+v0.2 ships the validated core set:
+
+- `clarify` — resolve only consequential ambiguity;
+- `spec` — turn evidence and decisions into acceptance criteria;
+- `slice-work` — divide work into verifiable vertical slices;
+- `tdd` — use public-seam red-green feedback loops;
+- `code-review` — review specification fidelity and engineering standards independently.
+
+## Updating YAAW
+
+Run the same command again:
+
+```bash
+npx yet-another-agentic-workflow@latest init
+```
+
+`init` handles installation, updates, provider reconfiguration, and repair. To add or remove providers non-interactively, pass the complete desired provider set with repeated `--provider` flags.
+
+## Existing-project safety
+
+YAAW owns only its delimited section in `CLAUDE.md` or `AGENTS.md`:
+
+```markdown
+<!-- yaaw:start -->
+...
+<!-- yaaw:end -->
+```
+
+Unrelated instruction content remains unchanged. Before updating or removing a generated skill, YAAW compares its current hash with `.yaaw/install.json`. Modified files are preserved and reported as conflicts; missing files are repaired on the next `init`. Writes are atomic and the manifest is written last.
+
+Inspect an installation at any time:
+
+```bash
+yaaw doctor
+```
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `yaaw init` | Install, update, reconfigure, or repair integrations |
+| `yaaw doctor` | Validate manifest, instruction blocks, skills, and hashes |
+| `yaaw version` | Show CLI and project-installed versions |
+| `yaaw --help` | Show the public command surface |
+| `yaaw --version` | Show the CLI version |
+
+## Philosophy
+
+YAAW keeps global instructions small and puts procedures in composable skills. The installer plans before writing, constrains generated paths to the target repository, preserves user-owned configuration, and stays out of the way after setup.
+
+## Contributing
+
+```bash
+npm ci
+npm run typecheck
+npm test
+npm run test:package
+```
+
+Package verification confirms that a clean packed artifact contains the CLI and skill assets and can initialize a temporary repository.

package/dist/adapters.d.ts

@@ -0,0 +1,43 @@
+export type AdapterName = "claude" | "codex";
+export interface AdapterSyncOptions {
+    check?: boolean;
+    force?: boolean;
+}
+export interface AdapterSkillRecord {
+    name: string;
+    source: string;
+    target: string;
+    sourceHash: string;
+    outputHash: string;
+}
+export interface AdapterManifest {
+    version: 1;
+    adapter: AdapterName;
+    sourceRoot: ".yaaw/skills";
+    targetRoot: string;
+    skills: AdapterSkillRecord[];
+}
+export interface AdapterDifference {
+    name: string;
+    kind: "missing" | "outdated" | "stale" | "conflict";
+    target: string;
+}
+export interface AdapterSyncResult {
+    adapter: AdapterName;
+    root: string;
+    sourceRoot: string;
+    targetRoot: string;
+    manifestPath: string;
+    check: boolean;
+    ok: boolean;
+    changed: boolean;
+    written: string[];
+    unchanged: string[];
+    removed: string[];
+    differences: AdapterDifference[];
+}
+export declare class AdapterError extends Error {
+    constructor(message: string);
+}
+/** Materialize every canonical YAAW skill into one harness representation. */
+export declare function syncAdapterSkills(adapter: AdapterName, projectDirectory?: string, options?: AdapterSyncOptions): Promise<AdapterSyncResult>;

package/dist/adapters.js

@@ -0,0 +1,191 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rename, rmdir, unlink, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { stringify } from "yaml";
+import { discoverSkills, invokeSkill } from "./skills.js";
+export class AdapterError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AdapterError";
+    }
+}
+const TARGETS = {
+    claude: ".claude/skills",
+    codex: ".agents/skills"
+};
+function hash(source) {
+    return createHash("sha256").update(source).digest("hex");
+}
+function slash(path) {
+    return path.replaceAll("\\", "/");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readOptional(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+async function atomicWrite(path, source) {
+    await mkdir(dirname(path), { recursive: true });
+    const temporary = `${path}.${process.pid}.tmp`;
+    await writeFile(temporary, source, "utf8");
+    await rename(temporary, path);
+}
+function outputDocument(name, description, instructions) {
+    const frontmatter = stringify({ name, description }).trimEnd();
+    return `---\n${frontmatter}\n---\n${instructions.trim()}\n`;
+}
+function targetPath(root, targetRoot, name) {
+    return join(root, targetRoot, name, "SKILL.md");
+}
+function assertManagedTarget(root, targetRoot, target) {
+    const boundary = resolve(root, targetRoot);
+    const absolute = resolve(root, target);
+    if (absolute !== boundary && !absolute.startsWith(`${boundary}${sep}`)) {
+        throw new AdapterError(`adapter manifest target escapes '${targetRoot}': ${target}`);
+    }
+    return absolute;
+}
+async function readManifest(path, adapter) {
+    const source = await readOptional(path);
+    if (source === undefined)
+        return undefined;
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        throw new AdapterError(`${path} contains invalid JSON`);
+    }
+    if (!isRecord(value) || value.version !== 1 || value.adapter !== adapter || !Array.isArray(value.skills)) {
+        throw new AdapterError(`${path} is not a ${adapter} adapter manifest`);
+    }
+    for (const item of value.skills) {
+        if (!isRecord(item) || typeof item.name !== "string" || typeof item.source !== "string" || typeof item.target !== "string" || typeof item.sourceHash !== "string" || typeof item.outputHash !== "string") {
+            throw new AdapterError(`${path} contains an invalid skill record`);
+        }
+    }
+    return value;
+}
+/** Materialize every canonical YAAW skill into one harness representation. */
+export async function syncAdapterSkills(adapter, projectDirectory = ".", options = {}) {
+    if (options.check && options.force)
+        throw new AdapterError("--check and --force cannot be combined");
+    const root = resolve(projectDirectory);
+    const sourceRoot = join(root, ".yaaw", "skills");
+    const relativeTargetRoot = TARGETS[adapter];
+    const adapterTargetRoot = join(root, relativeTargetRoot);
+    const manifestPath = join(root, ".yaaw", "adapters", `${adapter}.json`);
+    const previous = await readManifest(manifestPath, adapter);
+    const previousByName = new Map(previous?.skills.map((record) => [record.name, record]) ?? []);
+    const summaries = await discoverSkills(root);
+    const records = [];
+    const written = [];
+    const unchanged = [];
+    const removed = [];
+    const differences = [];
+    for (const summary of summaries) {
+        const invocation = await invokeSkill(summary.name, root);
+        const loaded = invocation.skills.find(({ name }) => name === summary.name);
+        const source = await readFile(summary.path, "utf8");
+        const output = outputDocument(summary.name, summary.description ?? summary.purpose, loaded.instructions);
+        const absoluteTarget = targetPath(root, relativeTargetRoot, summary.name);
+        const target = slash(relative(root, absoluteTarget));
+        const current = await readOptional(absoluteTarget);
+        const old = previousByName.get(summary.name);
+        const currentHash = current === undefined ? undefined : hash(current);
+        const outputHash = hash(output);
+        const conflict = current !== undefined && currentHash !== outputHash && (!old || currentHash !== old.outputHash);
+        if (current === undefined)
+            differences.push({ name: summary.name, kind: "missing", target });
+        else if (conflict)
+            differences.push({ name: summary.name, kind: "conflict", target });
+        else if (currentHash !== outputHash)
+            differences.push({ name: summary.name, kind: "outdated", target });
+        if (!options.check) {
+            if (conflict && !options.force) {
+                throw new AdapterError(`${target} diverged from its generated ${adapter} copy; rerun with --force to replace it from .yaaw/skills`);
+            }
+            if (currentHash !== outputHash) {
+                await atomicWrite(absoluteTarget, output);
+                written.push(target);
+            }
+            else {
+                unchanged.push(target);
+            }
+        }
+        else if (currentHash === outputHash) {
+            unchanged.push(target);
+        }
+        records.push({
+            name: summary.name,
+            source: slash(relative(root, summary.path)),
+            target,
+            sourceHash: hash(source),
+            outputHash
+        });
+    }
+    const canonicalNames = new Set(records.map(({ name }) => name));
+    for (const stale of previous?.skills ?? []) {
+        if (canonicalNames.has(stale.name))
+            continue;
+        const absoluteTarget = assertManagedTarget(root, relativeTargetRoot, stale.target);
+        const current = await readOptional(absoluteTarget);
+        if (current === undefined)
+            continue;
+        const conflict = hash(current) !== stale.outputHash;
+        differences.push({ name: stale.name, kind: conflict ? "conflict" : "stale", target: stale.target });
+        if (options.check)
+            continue;
+        if (conflict && !options.force) {
+            throw new AdapterError(`${stale.target} is stale and locally modified; rerun with --force to remove the generated skill`);
+        }
+        await unlink(absoluteTarget);
+        try {
+            await rmdir(dirname(absoluteTarget));
+        }
+        catch (error) {
+            if (error.code !== "ENOTEMPTY")
+                throw error;
+        }
+        removed.push(stale.target);
+    }
+    const manifest = {
+        version: 1,
+        adapter,
+        sourceRoot: ".yaaw/skills",
+        targetRoot: slash(relativeTargetRoot),
+        skills: records
+    };
+    const manifestSource = `${JSON.stringify(manifest, null, 2)}\n`;
+    const oldManifestSource = await readOptional(manifestPath);
+    const manifestChanged = oldManifestSource !== manifestSource;
+    if (!options.check && manifestChanged)
+        await atomicWrite(manifestPath, manifestSource);
+    if (options.check && manifestChanged && differences.length === 0) {
+        differences.push({ name: "<manifest>", kind: "outdated", target: slash(relative(root, manifestPath)) });
+    }
+    const changed = written.length > 0 || removed.length > 0 || (!options.check && manifestChanged);
+    return {
+        adapter,
+        root,
+        sourceRoot,
+        targetRoot: adapterTargetRoot,
+        manifestPath,
+        check: options.check ?? false,
+        ok: options.check ? differences.length === 0 : true,
+        changed,
+        written,
+        unchanged,
+        removed,
+        differences
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/architect.d.ts

@@ -0,0 +1,38 @@
+import type { PrimitiveKind } from "./types.js";
+export interface ArchitectAnswers {
+    requiresJudgment: boolean;
+    deterministic: boolean;
+    isolated: boolean;
+    requiresProof: boolean;
+    requiresSequencing: boolean;
+    needsKnowledge: boolean;
+    needsPersistence: boolean;
+}
+export interface ArchitectDiagnosis {
+    problem: string;
+    kind: PrimitiveKind;
+    suggestedName: string;
+    answers: ArchitectAnswers;
+    reasons: string[];
+    scores: Record<PrimitiveKind, number>;
+}
+export interface ArchitectOptions {
+    name?: string;
+    dryRun?: boolean;
+    force?: boolean;
+}
+export interface ArchitectResult {
+    diagnosis: ArchitectDiagnosis;
+    name: string;
+    root: string;
+    configPath: string;
+    artifactPaths: string[];
+    changed: boolean;
+}
+export declare class ArchitectError extends Error {
+    constructor(message: string);
+}
+/** Diagnose a requirement before choosing a YAAW primitive. */
+export declare function diagnoseArchitecture(problem: string): ArchitectDiagnosis;
+/** Diagnose a problem, add the selected primitive to yaaw.yaml, and create its focused artifact. */
+export declare function architectWorkflow(problem: string, projectDirectory?: string, options?: ArchitectOptions): Promise<ArchitectResult>;