@antomanc/aginit 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.5.0] - 2026-10-15
+
+### Added
+
+- A VHS demo of the interactive wizard, capability selection and successful doctor run, embedded in the README for GitHub and npm.
+
+- Capability registry (`src/registry/`). Every skill, tool and test engine is one declarative entry: install steps, doctor checks, AGENTS.md routing row, rebuttals and docs. `init`, `list`, `add`, `remove`, `doctor` and the docs read it. See `docs/adr/0003-capability-registry-and-stack-agnostic-setup.md`.
+- Stack detection (`src/detect/`) for Flutter, Swift, Kotlin/Android, React Native/Expo, web frameworks, Node, Rust, Go and Python, with the host toolchain's commands in AGENTS.md.
+- Non-JS projects get no root `package.json`, `tsconfig.json` or Vitest files. Node-only tooling is refused for them with a pointer to `--testing e2e` or `native`.
+- New capabilities: Superpowers and `minimal` methodologies, `karpathy-guidelines` (default), agent-device (default UI driver for mobile), Chrome DevTools MCP, BrowserSkill, tester-army/e2e (root for Node projects, isolated `.agents/e2e/` otherwise), context-mode and Worktrunk add-ons.
+- CLI: `--platform`, `--methodology`, `--design`, `--testing`, `--ui-driver`, `--addons`, `--add-skill`, `--without`; `-y, --yes`; `aginit [options]` as a shortcut for `init`; `aginit list`, `aginit add`, `aginit remove`.
+- AGENTS.md gets a managed `<!-- aginit:start -->` block with Karpathy guardrails, a Task Routing table and an Anti-Rationalization table, plus `docs/agents/testing.md`, `ui-verification.md` and `workflows.md`. Existing AGENTS.md content stays as written.
+- Config: optional `platform`, `stack`, `capabilities`, `customCapabilities` and `disabledCapabilities`. Older configs load unchanged and their capabilities are inferred.
+- `aginit doctor` reports one row per active capability (skill files, CLIs, the Graft index).
+
+### Changed
+
+- The interactive wizard uses detected stack defaults and registry choices for platform, methodology, design, testing and UI automation, plus optional registry add-ons. Short labels and a setup summary make choices easier to review.
+
+- AGENTS.md's "AI Capabilities & Skills" list moved to `docs/agents/workflows.md`.
+- A generic preset on an existing Node project defaults to the project's own test runner (`native`) instead of claiming Vitest it never installed.
+
+### Fixed
+
+- Committed Claude helpers resolve Graft at runtime without personal machine paths.
+
+- THIRD_PARTY_NOTICES.md credited humanizer and Impeccable to the wrong authors. It now credits every integration, with licenses checked upstream; a test keeps it in sync with the registry.
+
 ## 0.4.1 — 2026-10-11
 
 ### Fixed

package/README.md

@@ -3,9 +3,10 @@
 **Set up a new or existing project for AI coding agents with one command.**
 
 aginit gives a repo what agents need to do good work from the first session: an `AGENTS.md`
-that explains the project, a curated set of engineering skills, a codebase graph so agents
-read less and understand more, and a test harness they can actually run. It wires up
-upstream tools instead of reimplementing them.
+that routes each task to the right doc, a curated set of engineering skills, a codebase graph
+so agents read less and understand more, a test harness they can actually run, and a way to
+see the UI they change. It works for web, native mobile (Flutter, Swift, Kotlin), React Native,
+backend and CLI projects, and it wires up upstream tools instead of reimplementing them.
 
 ```bash
 npx @antomanc/aginit
@@ -15,7 +16,7 @@ npx @antomanc/aginit
 [![npm version](https://img.shields.io/npm/v/@antomanc/aginit)](https://www.npmjs.com/package/@antomanc/aginit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-<p align="center"><img src="docs/assets/demo.gif" alt="aginit wizard creating a CLI project with AGENTS.md, skills and a Graft codebase graph" width="720"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/antomanc/aginit/main/docs/assets/demo.gif" alt="aginit v2 detecting a web project, configuring capabilities and e2e, and passing every doctor check" width="720"></p>
 
 > **Beta.** Expect flags and defaults to change before 1.0.
 
@@ -34,13 +35,17 @@ aginit sets all of this up the same way every time, and you can re-run it whenev
 
 | | |
 |---|---|
-| **Instructions** | `AGENTS.md` with the project's real commands, invariants and a first-session playbook, shared by Antigravity, Codex and any agent that reads `AGENTS.md`, plus a one-line `CLAUDE.md` (`@AGENTS.md`) so Claude Code loads it too |
-| **Skills** | All 27 stable [Matt Pocock skills](https://github.com/mattpocock/skills) (`tdd`, `code-review`, `diagnosing-bugs`, `to-spec`, `to-tickets`, `implement-spec`, `pr`...) plus [humanizer](https://github.com/blader/humanizer) and [ponytail](https://github.com/DietrichGebert/ponytail), installed in `.agents/skills/` via the [Skills CLI](https://github.com/vercel-labs/skills) and linked into `.claude/skills/` for Claude Code |
+| **Instructions** | A lean `AGENTS.md`: invariants, the project's real commands, Karpathy guardrails, a **Task Routing** table and an **Anti-Rationalization** table. Details live in `docs/agents/testing.md`, `ui-verification.md` and `workflows.md`, which agents load only when the task needs them. A one-line `CLAUDE.md` (`@AGENTS.md`) makes Claude Code read it too |
+| **Skills** | One methodology ([Matt Pocock skills](https://github.com/mattpocock/skills) by default, or [Superpowers](https://github.com/obra/superpowers), or none) plus [ponytail](https://github.com/DietrichGebert/ponytail), [karpathy-guidelines](https://github.com/multica-ai/andrej-karpathy-skills) and [humanizer](https://github.com/blader/humanizer). Installed in `.agents/skills/` via the [Skills CLI](https://github.com/vercel-labs/skills), linked into `.claude/skills/` |
 | **Codebase graph** | [Graft](https://www.npmjs.com/package/@nanonets/graft): `graft map` and `graft ask` give agents the relevant code spans before they grep |
-| **Test tooling** | Vitest for TypeScript projects, plus Playwright when a web framework is selected |
-| **Web extras** | [Impeccable](https://github.com/pbakaus/impeccable) for UI design and [agent-browser](https://github.com/vercel-labs/agent-browser) for visual QA, with its CLI and browser binaries installed so it works out of the box |
-| **Scaffolding** | Official Vite and Next.js scaffolders, or a Commander-based TypeScript CLI |
-| **Maintenance** | `aginit doctor` checks readiness; `aginit update` refreshes skills and the graph |
+| **Design** | [Impeccable](https://github.com/pbakaus/impeccable) on web and mobile (`/impeccable init`, `audit`, `polish`). It needs no Node, so it works in Flutter, Swift and Kotlin repos |
+| **UI verification** | [agent-browser](https://github.com/vercel-labs/agent-browser) for web, [agent-device](https://github.com/callstack/agent-device) for iOS Simulator and Android Emulator. Optional: [Chrome DevTools MCP](https://github.com/ChromeDevTools/chrome-devtools-mcp), [BrowserSkill](https://github.com/Tencent/BrowserSkill) |
+| **Testing** | Vitest (+ Playwright with a web framework) for Node projects, the host runner (`flutter test`, `cargo test`, ...) otherwise, and optionally [e2e](https://github.com/tester-army/e2e), natural-language E2E tests with a zero-cost replay cache |
+| **Add-ons** | [context-mode](https://github.com/mksglu/context-mode) keeps huge logs out of the context window; [Worktrunk](https://github.com/max-sixty/worktrunk) gives parallel agents their own worktrees |
+| **Maintenance** | `aginit list`, `add` and `remove` change capabilities in place; `doctor` checks every active one; `update` refreshes skills and the graph |
+
+Non-JS projects stay non-JS: aginit never adds a root `package.json` to a Flutter, Swift,
+Kotlin, Rust, Go or Python repo. e2e gets its own workspace in `.agents/e2e/`.
 
 ## Quick start
 
@@ -65,20 +70,59 @@ npm install -g @nanonets/graft
 ## Commands
 
 ```
-aginit new [name]   Create a new project
-aginit init         Add or update agent setup in the current directory
-aginit doctor       Check Node.js, package manager, Git, Graft, Codex, Skills CLI, agent-browser, Claude Code wiring and config
-aginit update       Update installed skills and rebuild the Graft index
+aginit [options]            Set up or update the current directory (same as aginit init)
+aginit new [name]           Create a new project
+aginit init                 Add or update agent setup in the current directory
+aginit list                 Show the capability registry and what this project enables
+aginit add <id|owner/repo>  Enable capabilities (installs skills, refreshes AGENTS.md and docs)
+aginit remove <id>          Disable capabilities and remove their skills
+aginit doctor               Check the environment and every active capability
+aginit update               Update installed skills and rebuild the Graft index
 ```
 
-Useful flags: `--preset web|cli|generic`, `--framework none|vite|next|existing`,
-`--package-manager pnpm|npm|yarn|bun`, `--dry-run`, `--no-skills`, `--no-graft`, `--no-git`.
+Bare `aginit` opens the wizard in a terminal and prints help elsewhere. The wizard detects your stack,
+then offers platform, methodology, design, testing, UI driver and optional add-on choices with a setup summary.
+Initializing an existing directory preserves its stack; Node-only tools are hidden for other stacks. Pass any option, or
+`--yes`, to initialize without prompts.
+
+Setup flags: `--preset web|cli|generic`, `--framework none|vite|next|existing`,
+`--package-manager pnpm|npm|yarn|bun`, `--dry-run`, `--yes`, `--no-skills`, `--no-graft`, `--no-git`.
+
+Capability flags (the platform is detected; flags override it):
+
+| Flag | Values |
+| --- | --- |
+| `--platform` | `auto`, `web`, `mobile-native`, `mobile-rn`, `backend`, `cli` |
+| `--methodology` | `pocock` (default), `superpowers`, `minimal` |
+| `--design` | `impeccable` (default for UI platforms), `none` |
+| `--testing` | `e2e`, `playwright`, `vitest`, `native` |
+| `--ui-driver` | `auto`, `agent-browser`, `agent-device`, `chrome-devtools-mcp`, `browserskill`, `none` |
+| `--addons` | `context-mode`, `worktrunk`, `chrome-devtools-mcp`, `browserskill` (comma-separated) |
+| `--add-skill` | any `owner/repo` skill repository (repeatable) |
+| `--without` | any capability id, e.g. `graft` or `humanizer` (repeatable) |
+
+### Examples
 
 ```bash
-aginit new my-app --preset web --framework vite
-aginit new my-app --preset web --framework next --package-manager npm
-aginit new my-cli --preset cli
-aginit init --preset generic --dry-run
+# Web: Vite app with agent-browser, Impeccable and e2e tests
+aginit new my-app --preset web --framework vite --testing e2e
+
+# Flutter / Swift / Kotlin: run inside the existing app. Detected as mobile-native, it gets
+# agent-device and Impeccable, and e2e is isolated in .agents/e2e/ (no root package.json)
+cd my_flutter_app && aginit --testing e2e
+cd .agents/e2e && npm install      # then: npx e2e run against a booted simulator
+
+# React Native / Expo: detected as mobile-rn (agent-device, the project's own test script)
+cd my-expo-app && aginit --yes
+
+# CLI or library without UI tooling, Superpowers instead of Pocock skills
+aginit init --platform cli --design none --methodology superpowers
+
+# Change an existing project
+aginit add context-mode worktrunk
+aginit add superpowers             # swaps out the current methodology
+aginit remove impeccable
+aginit list
 ```
 
 ## Presets
@@ -92,9 +136,40 @@ aginit init --preset generic --dry-run
 The web preset's `--framework none` (default) creates a TypeScript baseline without a bundler
 or browser tests. `existing` keeps the framework you already have.
 
-Your choices (preset, framework, package manager, agents, skill sources) are saved in
-`aginit.config.json`, so the next run starts from them. The package manager is also passed
-to framework scaffolders.
+Your choices (preset, framework, package manager, platform, stack, capabilities, skill
+sources) are saved in `aginit.config.json`, and a plain rerun applies them as written. The
+package manager is also passed to framework scaffolders. On a non-Node stack the preset is
+`generic`, which writes no Node files.
+
+## Extending the registry
+
+Every tool aginit knows is one entry in [`src/registry/catalog.ts`](src/registry/catalog.ts).
+`init`, `list`, `add`, `remove`, `doctor`, the AGENTS.md routing table and the `docs/agents/`
+pages all read from it, so a new skill takes one entry and no other code:
+
+```ts
+{
+  id: 'my-skill', name: 'My skill', description: 'What it does',
+  category: 'discipline', author: 'Me', repoUrl: 'https://github.com/me/my-skill',
+  license: 'MIT', supportedPlatforms: ['all'], requiresNodeInProjectRoot: false,
+  install: [{ kind: 'skills-sh', repo: 'me/my-skill', skills: ['my-skill'] }],
+  routing: { task: 'When to use it', read: '`my-skill` skill' }
+}
+```
+
+Without a release, add a skill repository to one project with `aginit add owner/repo` (or
+`--add-skill`), or declare it in `aginit.config.json`:
+
+```json
+"customCapabilities": [
+  { "id": "acme-review", "repo": "acme/agent-skills", "skills": ["review"],
+    "binary": { "bin": "acme", "install": "npm i -g acme-cli" } }
+],
+"disabledCapabilities": ["humanizer"]
+```
+
+Doctor then checks `.agents/skills/review/SKILL.md` and the `acme` CLI, and
+`docs/agents/workflows.md` lists the skill.
 
 ## Existing projects
 
@@ -102,14 +177,19 @@ to framework scaffolders.
 dependency versions and test configs, and only adds what's missing. If you already use a
 different test runner, aginit adds a separate `test:unit` script instead of touching yours.
 
-An existing `AGENTS.md` is preserved; aginit only appends its bootstrap section. Configs from
-older versions that used the retired default skill selection are upgraded to the current
-set, while a skill list you narrowed by hand stays as written.
+An existing `AGENTS.md` is preserved. aginit adds its managed block between
+`<!-- aginit:start -->` and `<!-- aginit:end -->`, above Graft's block, and refreshes only that
+block afterwards. The `docs/agents/` pages carry a marker line; delete it and aginit leaves
+that page to you. Configs from older versions keep loading unchanged. Their capabilities are
+inferred from `skills.sources` and the `codebase`/`browser` switches until you run
+`aginit add`, `remove` or pass a capability flag.
 
 ## Design
 
-- **Orchestrates, doesn't vendor.** Skills, Graft, Vite, Next.js and Playwright come from
-  their upstream tools. aginit picks good defaults and runs them.
+- **Orchestrates, doesn't vendor.** Skills, Graft, e2e, Vite, Next.js and Playwright come
+  from their upstream tools. aginit picks good defaults and runs them. CLIs it does not
+  install itself (agent-device, context-mode, `wt`, `bsk`) are checked, and the upstream
+  install command is printed.
 - **Idempotent.** Re-running the same init is safe; explicit options override saved settings.
 - **Honest dry-run.** `--dry-run` lists every planned operation without writing files or
   downloading tools. (Files produced by upstream scaffolders are only known after they run.)

package/THIRD_PARTY_NOTICES.md

@@ -1,28 +1,40 @@
 # Third-Party Notices & Upstream Capabilities
 
-Aginit is an orchestrator and bootstrapper that configures and integrates independent open-source tools and skills. Aginit does not vendor, fork, claim ownership of, or relicense upstream software.
+Aginit is an orchestrator and bootstrapper that configures and integrates independent open-source tools and skills. Aginit does not vendor, fork, claim ownership of, or relicense upstream software. Each capability is installed from its upstream source (the Skills CLI, npm, or the tool's own installer) when a project enables it.
 
-Each integrated upstream tool is governed by its respective authors and licenses:
+Each integrated upstream tool is governed by its respective authors and licenses. The capability registry (`src/registry/catalog.ts`) records the same author, license and repository for every entry, and the test suite checks that each one is listed here.
 
-- **Graft**
-  - Project: Codebase understanding & context graph CLI
-  - Author: NanoNets / Graft contributors
-  - Repository: https://github.com/NanoNets/context-graph-engine
+## Installers
 
 - **Skills CLI / skills.sh**
   - Project: Decentralized agent skill package installer
   - Author: Vercel Inc. and contributors
-  - Website: https://skills.sh
+  - License: MIT
+  - Repository: https://github.com/vercel-labs/skills
+
+## Codebase graph
+
+- **Graft** (now part of Trail-Code)
+  - Project: Codebase understanding & context graph CLI (`@nanonets/graft`)
+  - Author: NanoNets / Trail and Graft contributors
+  - License: MIT
+  - Repository: https://github.com/trailhq/Trail-Code (formerly NanoNets/context-graph-engine)
+
+## Methodology
 
 - **Matt Pocock Skills**
-  - Project: Workflow skills (`tdd`, `code-review`, `diagnosing-bugs`, `to-spec`, `to-tickets`, `implement-spec`)
+  - Project: Workflow skills (`tdd`, `code-review`, `diagnosing-bugs`, `to-spec`, `to-tickets`, `implement-spec`, ...)
   - Author: Matt Pocock
+  - License: MIT
   - Repository: https://github.com/mattpocock/skills
 
-- **Humanizer**
-  - Project: Agent skill that removes signs of AI-generated writing from text
-  - Author: Blake Robbins / Humanizer contributors
-  - Repository: https://github.com/blader/humanizer
+- **Superpowers**
+  - Project: Agentic skills framework and development methodology
+  - Author: Jesse Vincent (obra)
+  - License: MIT
+  - Repository: https://github.com/obra/superpowers
+
+## Discipline
 
 - **Ponytail**
   - Project: Agent skill for the smallest complete change and less over-engineering
@@ -30,18 +42,82 @@ Each integrated upstream tool is governed by its respective authors and licenses
   - License: MIT
   - Repository: https://github.com/DietrichGebert/ponytail
 
+- **Karpathy guidelines**
+  - Project: `karpathy-guidelines` skill, derived from Andrej Karpathy's observations on LLM coding pitfalls
+  - Author: Jiayuan Zhang (forrestchang)
+  - License: MIT, as declared in the skill's frontmatter (the repository has no LICENSE file)
+  - Repository: https://github.com/multica-ai/andrej-karpathy-skills (formerly forrestchang/andrej-karpathy-skills)
+
+- **Humanizer**
+  - Project: Agent skill that removes signs of AI-generated writing from text
+  - Author: Siqi Chen (blader)
+  - License: MIT
+  - Repository: https://github.com/blader/humanizer
+
+## Design
+
 - **Impeccable**
-  - Project: Frontend craft & design system review skill
-  - Author: Peter Bak-Hansen
+  - Project: Design language, design-system and anti-slop review skill for web and native UI
+  - Author: Paul Bakaus
+  - License: Apache-2.0
   - Repository: https://github.com/pbakaus/impeccable
 
+## UI drivers
+
 - **agent-browser**
-  - Project: Fast headless/CDP browser automation CLI for AI agents
+  - Project: Browser automation CLI for AI agents
   - Author: Vercel Labs
+  - License: Apache-2.0
   - Repository: https://github.com/vercel-labs/agent-browser
 
+- **agent-device**
+  - Project: iOS Simulator / Android Emulator automation for AI agents
+  - Author: Callstack
+  - License: MIT
+  - Repository: https://github.com/callstack/agent-device (formerly callstackincubator/agent-device)
+
+- **Chrome DevTools MCP**
+  - Project: Chrome DevTools for coding agents (network, performance, memory)
+  - Author: Google Chrome DevTools team
+  - License: Apache-2.0
+  - Repository: https://github.com/ChromeDevTools/chrome-devtools-mcp
+
+- **BrowserSkill**
+  - Project: Lets agents use the user's real, logged-in browser (`bsk`)
+  - Author: Tencent
+  - License: MIT
+  - Repository: https://github.com/Tencent/BrowserSkill
+
+## Testing
+
+- **Vitest**
+  - Project: Unit test framework
+  - Author: Vitest team
+  - License: MIT
+  - Repository: https://github.com/vitest-dev/vitest
+
 - **Playwright**
   - Project: End-to-end testing framework
   - Author: Microsoft Corporation
   - License: Apache-2.0
-  - Website: https://playwright.dev
+  - Repository: https://github.com/microsoft/playwright
+
+- **e2e**
+  - Project: AI-assisted end-to-end testing framework for web and mobile apps with a replay cache
+  - Author: TesterArmy
+  - License: Apache-2.0
+  - Repository: https://github.com/tester-army/e2e
+
+## Context guards (opt-in add-ons)
+
+- **context-mode**
+  - Project: Context window optimization that sandboxes large tool output
+  - Author: Mert Köseoğlu (mksglu)
+  - License: Elastic License 2.0 (ELv2). This is a source-available license, not an OSI open-source license; review its terms before enabling the add-on.
+  - Repository: https://github.com/mksglu/context-mode
+
+- **Worktrunk**
+  - Project: Git worktree manager for parallel agents (`wt`)
+  - Author: Maximilian Roos (max-sixty)
+  - License: MIT OR Apache-2.0
+  - Repository: https://github.com/max-sixty/worktrunk

package/dist/adapters/agent-docs.d.ts

@@ -0,0 +1,32 @@
+import { AginitConfig } from '../config/schema.js';
+import { CapabilityDescriptor, GuideContext, MicroDoc, Platform, Stack } from '../registry/index.js';
+export interface ProjectProfile extends GuideContext {
+    active: CapabilityDescriptor[];
+}
+/** Platform and stack: saved in v2 configs, detected for older ones. */
+export declare function resolvePlatformStack(config: AginitConfig, targetDir?: string): {
+    platform: Platform;
+    stack: Stack;
+};
+export declare function projectProfile(config: AginitConfig, options?: {
+    targetDir?: string;
+    scripts?: Record<string, string>;
+}): ProjectProfile;
+export declare const DOCS_DIR: string;
+export declare const GENERATED_MARKER = "<!-- Generated by aginit from aginit.config.json. Rerun `aginit` to refresh; delete this line to edit by hand. -->";
+/** Markdown for one micro-doc, or null when no active capability contributes to it. */
+export declare function renderMicroDoc(doc: MicroDoc, profile: ProjectProfile): string | null;
+export declare const MICRO_DOCS: MicroDoc[];
+export declare function microDocPath(doc: MicroDoc): string;
+/**
+ * Write the docs/agents/ micro-docs for the active capabilities. A doc whose
+ * marker line was removed belongs to the user and is never touched; a doc no
+ * capability contributes to any more is deleted. Returns the docs that exist.
+ */
+export declare function setupMicroDocs(targetDir: string, profile: ProjectProfile, options?: {
+    dryRun?: boolean;
+    silent?: boolean;
+}): MicroDoc[];
+/** Docs that will exist for a profile (used when rendering AGENTS.md without a target). */
+export declare function plannedMicroDocs(profile: ProjectProfile): MicroDoc[];
+//# sourceMappingURL=agent-docs.d.ts.map

package/dist/adapters/agent-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-docs.d.ts","sourceRoot":"","sources":["../../src/adapters/agent-docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAEL,oBAAoB,EAGpB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,KAAK,EACN,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAQtC;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GACrE,cAAc,CAehB;AAED,eAAO,MAAM,QAAQ,QAA8B,CAAC;AACpD,eAAO,MAAM,gBAAgB,uHACyF,CAAC;AAsDvH,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAmBpF;AAED,eAAO,MAAM,UAAU,EAAE,QAAQ,EAAgD,CAAC;AAElF,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAElD;AAQD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,QAAQ,EAAE,CAuBZ;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,EAAE,CAEpE"}

package/dist/adapters/agent-docs.js

@@ -0,0 +1,146 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { presetPlatform } from '../config/defaults.js';
+import { detectProject, projectCommands } from '../detect/index.js';
+import { activeCapabilities, CATALOG, e2eDirFor } from '../registry/index.js';
+import { readTextFile, safeWriteFile } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+/** Platform and stack: saved in v2 configs, detected for older ones. */
+export function resolvePlatformStack(config, targetDir) {
+    const detected = targetDir && (!config.platform || !config.stack) ? detectProject(targetDir) : null;
+    return {
+        platform: config.platform ??
+            (config.preset !== 'generic' ? presetPlatform(config.preset) : (detected?.platform ?? 'cli')),
+        stack: config.stack ?? (detected && detected.stack !== 'unknown' ? detected.stack : 'node')
+    };
+}
+export function projectProfile(config, options = {}) {
+    const { platform, stack } = resolvePlatformStack(config, options.targetDir);
+    const active = activeCapabilities(config);
+    const ids = new Set(active.map((c) => c.id));
+    return {
+        platform,
+        stack,
+        active,
+        has: (id) => ids.has(id),
+        commands: projectCommands(options.targetDir ?? '.', stack, {
+            packageManager: config.packageManager,
+            scripts: options.scripts
+        }),
+        e2eDir: e2eDirFor(stack)
+    };
+}
+export const DOCS_DIR = path.join('docs', 'agents');
+export const GENERATED_MARKER = '<!-- Generated by aginit from aginit.config.json. Rerun `aginit` to refresh; delete this line to edit by hand. -->';
+const DOC_TITLES = {
+    testing: 'Testing',
+    'ui-verification': 'Live UI verification',
+    workflows: 'Engineering workflows & skills'
+};
+const skillNames = (capability) => capability.install.flatMap((step) => (step.kind === 'skills-sh' ? step.skills : []));
+function testingIntro(profile) {
+    const { commands } = profile;
+    const rows = [
+        ['Build', commands.build],
+        ['Typecheck', commands.typecheck],
+        ['Lint / analyze', commands.lint],
+        ['Test', commands.test],
+        ['Unit test', commands.unitTest],
+        ['E2E', commands.e2e]
+    ];
+    const lines = rows.filter(([, cmd]) => cmd).map(([label, cmd]) => `- ${label}: \`${cmd}\``);
+    return lines.length
+        ? ['Run the full check before calling a change done:', ...lines]
+        : ['Record the project build and test commands here once they exist.'];
+}
+function workflowsExtras(profile) {
+    // Skill capabilities without their own guide still show up, so new registry
+    // entries and custom skill repos are documented without extra code.
+    const plain = profile.active.filter((c) => !c.guide && c.install.some((step) => step.kind === 'skills-sh'));
+    const bullet = (c) => {
+        const skills = skillNames(c);
+        const label = skills.length ? skills.map((s) => '`' + s + '`').join(', ') : `\`${c.id}\``;
+        return `- ${label}: ${c.description}.`;
+    };
+    const discipline = plain.filter((c) => c.category === 'discipline');
+    const others = plain.filter((c) => c.category !== 'discipline');
+    return [
+        ...(discipline.length ? ['## Discipline (apply to every change)', ...discipline.map(bullet)] : []),
+        ...(others.length ? ['', '## Other skills', ...others.map(bullet)] : [])
+    ];
+}
+// Drivers come before the design review that uses them; unit runners before E2E.
+const SECTION_ORDER = ['methodology', 'ui-driver', 'design', 'testing-engine', 'context-guard'];
+const sectionRank = (c) => {
+    const category = SECTION_ORDER.indexOf(c.category);
+    const index = CATALOG.indexOf(c);
+    return (category === -1 ? SECTION_ORDER.length : category) * 1000 + (index === -1 ? 999 : index);
+};
+/** Markdown for one micro-doc, or null when no active capability contributes to it. */
+export function renderMicroDoc(doc, profile) {
+    const sections = profile.active
+        .filter((c) => c.guide?.doc === doc)
+        .sort((a, b) => sectionRank(a) - sectionRank(b))
+        .map((c) => c.guide.render(profile));
+    const extras = doc === 'workflows' ? workflowsExtras(profile) : [];
+    if (sections.length === 0 && extras.length === 0)
+        return null;
+    const intro = doc === 'testing'
+        ? testingIntro(profile)
+        : doc === 'workflows'
+            ? [
+                'Skills live in `.agents/skills/` (linked into `.claude/skills/` for Claude Code). Invoke one by name',
+                '(for example `/tdd`), or let the agent pick it from its description.'
+            ]
+            : ['Verify UI changes in the running app, not only in tests.'];
+    const body = [`# ${DOC_TITLES[doc]}`, '', ...intro, '', ...sections.flatMap((s) => [s, ''])];
+    if (extras.length)
+        body.push(...extras, '');
+    return [GENERATED_MARKER, ...body].join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
+}
+export const MICRO_DOCS = ['testing', 'ui-verification', 'workflows'];
+export function microDocPath(doc) {
+    return path.join(DOCS_DIR, `${doc}.md`).split(path.sep).join('/');
+}
+/** Docs aginit owns: files it wrote that still carry the generated marker. */
+function ownedByAginit(file) {
+    const text = readTextFile(file);
+    return text === null || text.startsWith(GENERATED_MARKER);
+}
+/**
+ * Write the docs/agents/ micro-docs for the active capabilities. A doc whose
+ * marker line was removed belongs to the user and is never touched; a doc no
+ * capability contributes to any more is deleted. Returns the docs that exist.
+ */
+export function setupMicroDocs(targetDir, profile, options = {}) {
+    const { dryRun = false, silent = false } = options;
+    const present = [];
+    for (const doc of MICRO_DOCS) {
+        const file = path.join(targetDir, DOCS_DIR, `${doc}.md`);
+        const content = renderMicroDoc(doc, profile);
+        if (!ownedByAginit(file)) {
+            if (!silent)
+                logger.dim(`${microDocPath(doc)} was edited by hand, preserving it.`);
+            present.push(doc);
+            continue;
+        }
+        if (content === null) {
+            if (fs.existsSync(file)) {
+                if (dryRun)
+                    logger.dim(`[dry-run] Would remove file: ${file}`);
+                else
+                    fs.rmSync(file);
+            }
+            continue;
+        }
+        present.push(doc);
+        if (readTextFile(file) !== content)
+            safeWriteFile(file, content, { overwrite: true, dryRun, silent });
+    }
+    return present;
+}
+/** Docs that will exist for a profile (used when rendering AGENTS.md without a target). */
+export function plannedMicroDocs(profile) {
+    return MICRO_DOCS.filter((doc) => renderMicroDoc(doc, profile) !== null);
+}
+//# sourceMappingURL=agent-docs.js.map

package/dist/adapters/agent-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-docs.js","sourceRoot":"","sources":["../../src/adapters/agent-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EACL,kBAAkB,EAElB,OAAO,EACP,SAAS,EAKV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAM5C,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAClC,MAAoB,EACpB,SAAkB;IAElB,MAAM,QAAQ,GAAG,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpG,OAAO;QACL,QAAQ,EACN,MAAM,CAAC,QAAQ;YACf,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,IAAI,KAAK,CAAC,CAAC;QAC/F,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;KAC5F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAoB,EACpB,OAAO,GAA6D,EAAE;IAEtE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO;QACL,QAAQ;QACR,KAAK;QACL,MAAM;QACN,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE,KAAK,EAAE;YACzD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACF,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,oHAAoH,CAAC;AAEvH,MAAM,UAAU,GAA6B;IAC3C,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,sBAAsB;IACzC,SAAS,EAAE,gCAAgC;CAC5C,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,UAAgC,EAAE,EAAE,CACtD,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvF,SAAS,YAAY,CAAC,OAAuB;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,IAAI,GAAwC;QAChD,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QACzB,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC;QACjC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,IAAI,CAAC;QACjC,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAChC,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5F,OAAO,KAAK,CAAC,MAAM;QACjB,CAAC,CAAC,CAAC,kDAAkD,EAAE,GAAG,KAAK,CAAC;QAChE,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,eAAe,CAAC,OAAuB;IAC9C,4EAA4E;IAC5E,oEAAoE;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CACvE,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,CAAuB,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QAC1F,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC;IACzC,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;IAChE,OAAO;QACL,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,uCAAuC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAChG,MAAM,WAAW,GAAG,CAAC,CAAuB,EAAE,EAAE;IAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC,CAAC;AAEF,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,GAAa,EAAE,OAAuB;IACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;SACnC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,MAAM,KAAK,GACT,GAAG,KAAK,SAAS;QACf,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC;QACvB,CAAC,CAAC,GAAG,KAAK,WAAW;YACnB,CAAC,CAAC;gBACE,sGAAsG;gBACtG,sEAAsE;aACvE;YACH,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7F,IAAI,MAAM,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAe,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAC;AAElF,MAAM,UAAU,YAAY,CAAC,GAAa;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,OAAuB,EACvB,OAAO,GAA2C,EAAE;IAEpD,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YACnF,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,IAAI,MAAM;oBAAE,MAAM,CAAC,GAAG,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;;oBAC1D,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,OAAO;YAChC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;AAC3E,CAAC"}

package/dist/adapters/agents-md.d.ts

@@ -1,9 +1,21 @@
 import { AginitConfig } from '../config/schema.js';
-export declare function generateAgentsMarkdown(config: AginitConfig, scripts?: Record<string, string>): string;
+import { MicroDoc } from '../registry/index.js';
+import { ProjectProfile } from './agent-docs.js';
+export declare const AGINIT_BLOCK_START = "<!-- aginit:start -->";
+export declare const AGINIT_BLOCK_END = "<!-- aginit:end -->";
+/**
+ * The part of AGENTS.md aginit keeps in sync with the active capabilities:
+ * guardrails, the Task Routing table and the Anti-Rationalization table.
+ */
+export declare function renderAgentsBlock(config: AginitConfig, profile: ProjectProfile, docs?: MicroDoc[]): string;
+export declare function generateAgentsMarkdown(config: AginitConfig, scripts?: Record<string, string>, targetDir?: string): string;
+/** Insert or refresh the aginit block in an existing AGENTS.md, leaving everything else as written. */
+export declare function mergeAgentsBlock(existing: string, block: string): string;
 export declare function setupAgentsMarkdown(targetDir: string, config: AginitConfig, options?: {
     overwrite?: boolean;
     dryRun?: boolean;
     silent?: boolean;
+    docs?: MicroDoc[];
 }): boolean;
 export declare const CLAUDE_AGENTS_IMPORT = "@AGENTS.md";
 /**

package/dist/adapters/agents-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/adapters/agents-md.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAmIR;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACxE,OAAO,CA+BT;AAED,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAQT;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE"}
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/adapters/agents-md.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAqC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAIL,cAAc,EAEf,MAAM,iBAAiB,CAAC;AAUzB,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAuBtD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,QAAQ,EAA8B,GAC3C,MAAM,CAyDR;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CA4CR;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAO,GAC3F,OAAO,CAqBT;AAED,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAQT;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE"}