diff --git a/docs/fish-config.1 b/docs/fish-config.1 index 9c113d5..93f5fe4 100644 --- a/docs/fish-config.1 +++ b/docs/fish-config.1 @@ -1449,17 +1449,30 @@ Runs the antigravity-ide editor with warnings filtered. .nf \f[C] Synopsis: agents-init [--agents | --plugins] -Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin -directories. Creates AGENTS/ as a standalone git repo, initializes -standard plugin subdirectories (superpowers/, plans/, specs/), moves any -existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces -them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so -Claude Code picks up the shared agent instructions. Adds all managed -paths to .gitignore and auto-commits every change inside the AGENTS/ -sub-repo. Fully idempotent: a second run produces no output and no new -commits. Flags: --agents re-runs only the AGENTS.md / symlink step; ---plugins re-runs only the plugin-directory wiring step. Called -automatically by the claude and agy wrappers on every invocation. +Scaffold an AGENTS/ sub-repository for tracking agent specs, plans, specs, +and dev logs. Creates AGENTS/ as a standalone git repo, moves any existing +AGENTS.md into it, and replaces it with a relative symlink (plus +CLAUDE.md -> AGENTS/AGENTS.md so Claude Code picks up the shared agent +instructions). Consolidates plans/ and specs/ directly under AGENTS/ +(merging any legacy docs/plans, docs/superpowers/plans, or old +AGENTS/plugins/ locations into the canonical AGENTS/), creates +AGENTS/devlogs/, and wires docs/superpowers/{plans,specs} symlinks back to +them. Adds managed paths to .gitignore and auto-commits every change inside +the AGENTS/ sub-repo; pulls first when the sub-repo has an upstream. +Fully idempotent: a second run produces no output and no new commits. +Flags: --agents re-runs only the AGENTS.md / symlink step; --plugins +re-runs only the plans/specs/devlogs wiring step. Called automatically by +the claude and agy wrappers on every invocation. + +Structure versioning: each AGENTS/ repo carries a self-contained version +bumper. AGENTS/.version holds MAJOR.MINOR.PATCH (seeded 1.0.0). Committed +git hooks under AGENTS/.agents-tools/ (wired via core.hooksPath) bump it on +every commit: MINOR (resetting PATCH) when the tracked directory set +changes, PATCH otherwise; MAJOR is manual-only. A prepare-commit-msg hook +appends \[dq](vX.Y.Z)\[dq] to the commit subject. Downstream tooling can read +AGENTS/.version - a changed MINOR field signals a structure change. The +script and hooks are shipped from scripts/agents-tools/ and refreshed when +their version marker is stale. agents-init agents-init --agents diff --git a/docs/html/9-5-functions-reference.html b/docs/html/9-5-functions-reference.html index 71fd350..e48e37e 100644 --- a/docs/html/9-5-functions-reference.html +++ b/docs/html/9-5-functions-reference.html @@ -961,17 +961,30 @@ agy resume Runs the antigravity-ide editor with warnings filtered.

agents-init

Synopsis:  agents-init [--agents | --plugins]
-Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
-directories. Creates AGENTS/ as a standalone git repo, initializes
-standard plugin subdirectories (superpowers/, plans/, specs/), moves any
-existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
-them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so
-Claude Code picks up the shared agent instructions. Adds all managed
-paths to .gitignore and auto-commits every change inside the AGENTS/
-sub-repo. Fully idempotent: a second run produces no output and no new
-commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
---plugins re-runs only the plugin-directory wiring step. Called
-automatically by the claude and agy wrappers on every invocation.
+Scaffold an AGENTS/ sub-repository for tracking agent specs, plans, specs,
+and dev logs. Creates AGENTS/ as a standalone git repo, moves any existing
+AGENTS.md into it, and replaces it with a relative symlink (plus
+CLAUDE.md -> AGENTS/AGENTS.md so Claude Code picks up the shared agent
+instructions). Consolidates plans/ and specs/ directly under AGENTS/
+(merging any legacy docs/plans, docs/superpowers/plans, or old
+AGENTS/plugins/ locations into the canonical AGENTS/<tgt>), creates
+AGENTS/devlogs/, and wires docs/superpowers/{plans,specs} symlinks back to
+them. Adds managed paths to .gitignore and auto-commits every change inside
+the AGENTS/ sub-repo; pulls first when the sub-repo has an upstream.
+Fully idempotent: a second run produces no output and no new commits.
+Flags: --agents re-runs only the AGENTS.md / symlink step; --plugins
+re-runs only the plans/specs/devlogs wiring step. Called automatically by
+the claude and agy wrappers on every invocation.
+
+Structure versioning: each AGENTS/ repo carries a self-contained version
+bumper. AGENTS/.version holds MAJOR.MINOR.PATCH (seeded 1.0.0). Committed
+git hooks under AGENTS/.agents-tools/ (wired via core.hooksPath) bump it on
+every commit: MINOR (resetting PATCH) when the tracked directory set
+changes, PATCH otherwise; MAJOR is manual-only. A prepare-commit-msg hook
+appends "(vX.Y.Z)" to the commit subject. Downstream tooling can read
+AGENTS/.version - a changed MINOR field signals a structure change. The
+script and hooks are shipped from scripts/agents-tools/ and refreshed when
+their version marker is stale.
 
 agents-init
 agents-init --agents
diff --git a/docs/wiki/5-functions-reference.md b/docs/wiki/5-functions-reference.md
index c1f6f47..087bbb3 100644
--- a/docs/wiki/5-functions-reference.md
+++ b/docs/wiki/5-functions-reference.md
@@ -620,17 +620,30 @@
 ### agents-init
 
     Synopsis:  agents-init [--agents | --plugins]
-    Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
-    directories. Creates AGENTS/ as a standalone git repo, initializes
-    standard plugin subdirectories (superpowers/, plans/, specs/), moves any
-    existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
-    them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so
-    Claude Code picks up the shared agent instructions. Adds all managed
-    paths to .gitignore and auto-commits every change inside the AGENTS/
-    sub-repo. Fully idempotent: a second run produces no output and no new
-    commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
-    --plugins re-runs only the plugin-directory wiring step. Called
-    automatically by the claude and agy wrappers on every invocation.
+    Scaffold an AGENTS/ sub-repository for tracking agent specs, plans, specs,
+    and dev logs. Creates AGENTS/ as a standalone git repo, moves any existing
+    AGENTS.md into it, and replaces it with a relative symlink (plus
+    CLAUDE.md -> AGENTS/AGENTS.md so Claude Code picks up the shared agent
+    instructions). Consolidates plans/ and specs/ directly under AGENTS/
+    (merging any legacy docs/plans, docs/superpowers/plans, or old
+    AGENTS/plugins/ locations into the canonical AGENTS/), creates
+    AGENTS/devlogs/, and wires docs/superpowers/{plans,specs} symlinks back to
+    them. Adds managed paths to .gitignore and auto-commits every change inside
+    the AGENTS/ sub-repo; pulls first when the sub-repo has an upstream.
+    Fully idempotent: a second run produces no output and no new commits.
+    Flags: --agents re-runs only the AGENTS.md / symlink step; --plugins
+    re-runs only the plans/specs/devlogs wiring step. Called automatically by
+    the claude and agy wrappers on every invocation.
+
+    Structure versioning: each AGENTS/ repo carries a self-contained version
+    bumper. AGENTS/.version holds MAJOR.MINOR.PATCH (seeded 1.0.0). Committed
+    git hooks under AGENTS/.agents-tools/ (wired via core.hooksPath) bump it on
+    every commit: MINOR (resetting PATCH) when the tracked directory set
+    changes, PATCH otherwise; MAJOR is manual-only. A prepare-commit-msg hook
+    appends "(vX.Y.Z)" to the commit subject. Downstream tooling can read
+    AGENTS/.version - a changed MINOR field signals a structure change. The
+    script and hooks are shipped from scripts/agents-tools/ and refreshed when
+    their version marker is stale.
 
     agents-init
     agents-init --agents