@afokapu/atdd-bun 0.1.2 → 0.1.3

package/README.md

@@ -137,10 +137,9 @@ bun run atdd-bun init
 ```
 
 It creates `.githooks/` dispatchers, sets a worktree-local `core.hooksPath`,
-generates `.github/workflows/atdd-bun.yml`, and writes the coding-agent skill
-`.claude/skills/atdd/SKILL.md` when they are absent. It never overwrites another
-hook path, an existing generated workflow, or an existing skill unless you
-explicitly pass `--replace`. Installing the dependency alone deliberately does
+generates `.github/workflows/atdd-bun.yml`, and installs the coding-agent skill
+when they are absent. It never overwrites another hook path, an existing
+generated workflow, or an existing skill unless you explicitly pass `--replace`. Installing the dependency alone deliberately does
 neither: package installation must not mutate a repository through postinstall.
 
 Use `hooks install`, `ci init`, or `agent init` when only one surface is wanted:
@@ -165,13 +164,21 @@ workflow and GitHub branch ruleset are the authority for merging.
 
 ## Agent skill: the lifecycle in the agent's context
 
-`agent init` writes `.claude/skills/atdd/SKILL.md`, a short skill that coding
-agents load before changing code, tests, or `plan/`. It names the lifecycle
-PLAN → RED → GREEN → SMOKE → REFACTOR → TRACE, the conventions each stage
-follows, and the `atdd-bun` profile that gates it. It points at the conventions
-shipped in this package instead of restating them, so it stays correct as they
-change; after upgrading, refresh it with `bun run atdd-bun agent init --replace`.
-The skill steers the agent; the profiles, hooks, and CI remain the enforcement.
+`agent init` gives every coding agent the same short ATDD skill:
+
+- `.agents/skills/atdd/SKILL.md`: the vendor-neutral Agent Skills path (Codex,
+  GitHub Copilot, Cursor, Gemini CLI, and others);
+- `.claude/skills/atdd/SKILL.md`: Claude Code;
+- a managed `<!-- atdd-bun:start -->` block in `AGENTS.md` pointing at the skill,
+  for agents that read `AGENTS.md` but not skills. The rest of `AGENTS.md` is
+  never touched.
+
+The skill names the lifecycle PLAN → RED → GREEN → SMOKE → REFACTOR → TRACE, the
+conventions each stage follows, and the `atdd-bun` profile that gates it. It
+points at the conventions shipped in this package instead of restating them, so
+it stays correct as they change; after upgrading, refresh it with
+`bun run atdd-bun agent init --replace`. The skill steers the agent; the
+profiles, hooks, and CI remain the enforcement.
 
 ## CI: the merge gate
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-bun",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/afokapu/atdd-bun.git"

package/src/agent.ts

@@ -1,10 +1,31 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 
 const root = resolve(import.meta.dir, "..");
-const template = join(root, "templates/claude/atdd/SKILL.md");
 const version = (await Bun.file(join(root, "package.json")).json() as { version: string }).version;
-const skillDir = (repo: string) => join(repo, ".claude/skills/atdd");
-export async function agentInit(repo = process.cwd(), replace = false) { const output = join(skillDir(repo), "SKILL.md"); if (existsSync(output) && !replace) return { ok: false, message: `${output} exists; use --replace` }; await mkdir(skillDir(repo), { recursive: true }); await writeFile(output, (await readFile(template, "utf8")).replace("{{VERSION}}", version)); return { ok: true, message: output }; }
-export async function agentStatus(repo = process.cwd()) { const output = join(skillDir(repo), "SKILL.md"); return { ok: existsSync(output), message: output }; }
+const render = async (path: string) => (await readFile(join(root, "templates/agents", path), "utf8")).replace("{{VERSION}}", version);
+// .agents/skills is the vendor-neutral Agent Skills path (Codex, Copilot, Cursor, Gemini CLI, …); .claude/skills is Claude Code's.
+const skillPaths = [".agents/skills/atdd/SKILL.md", ".claude/skills/atdd/SKILL.md"];
+const block = /<!-- atdd-bun:start[\s\S]*?<!-- atdd-bun:end -->\n?/;
+
+/** Write the ATDD skill for every agent and a managed pointer block in AGENTS.md. Existing files and an
+ * existing block are kept unless `replace`; the rest of AGENTS.md is never touched. */
+export async function agentInit(repo = process.cwd(), replace = false) {
+  const written: string[] = [], kept: string[] = [];
+  for (const path of skillPaths) {
+    const output = join(repo, path);
+    if (existsSync(output) && !replace) { kept.push(output); continue; }
+    await mkdir(dirname(output), { recursive: true }); await writeFile(output, await render("atdd/SKILL.md")); written.push(output);
+  }
+  const agents = join(repo, "AGENTS.md"), current = existsSync(agents) ? await readFile(agents, "utf8") : "", managed = await render("AGENTS.block.md");
+  if (block.test(current) && !replace) kept.push(agents);
+  else { await writeFile(agents, block.test(current) ? current.replace(block, managed) : current + (current && !current.endsWith("\n\n") ? (current.endsWith("\n") ? "\n" : "\n\n") : "") + managed); written.push(agents); }
+  if (!written.length) return { ok: false, message: `${kept.join(", ")} exist; use --replace` };
+  return { ok: true, message: written.join("\n") };
+}
+export async function agentStatus(repo = process.cwd()) {
+  const agents = join(repo, "AGENTS.md"), missing = skillPaths.map(path => join(repo, path)).filter(path => !existsSync(path));
+  if (!existsSync(agents) || !block.test(await readFile(agents, "utf8"))) missing.push(`${agents} (atdd-bun block)`);
+  return { ok: !missing.length, message: missing.length ? `missing: ${missing.join(", ")}` : [...skillPaths, "AGENTS.md"].map(path => join(repo, path)).join("\n") };
+}

package/templates/agents/AGENTS.block.md

@@ -0,0 +1,5 @@
+<!-- atdd-bun:start — generated by @afokapu/atdd-bun {{VERSION}}; run `atdd-bun agent init --replace` to refresh -->
+## ATDD lifecycle
+
+Before changing code, tests, or `plan/`, follow `.agents/skills/atdd/SKILL.md`: PLAN → RED → GREEN → SMOKE → REFACTOR → TRACE, passing each stage's `atdd-bun` gate before starting the next.
+<!-- atdd-bun:end -->