chore(docs): regenerate man page, HTML docs, and wiki

2026-06-18 02:10:46 +00:00
parent b81cbd3b02
commit 3bdc712fa9
3 changed files with 72 additions and 33 deletions
@@ -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
+Scaffold an AGENTS/ sub-repository for tracking agent specs, plans, specs,
-directories. Creates AGENTS/ as a standalone git repo, initializes
+and dev logs. Creates AGENTS/ as a standalone git repo, moves any existing
-standard plugin subdirectories (superpowers/, plans/, specs/), moves any
+AGENTS.md into it, and replaces it with a relative symlink (plus
-existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
+CLAUDE.md -> AGENTS/AGENTS.md so Claude Code picks up the shared agent
-them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so
+instructions). Consolidates plans/ and specs/ directly under AGENTS/
-Claude Code picks up the shared agent instructions. Adds all managed
+(merging any legacy docs/plans, docs/superpowers/plans, or old
-paths to .gitignore and auto-commits every change inside the AGENTS/
+AGENTS/plugins/ locations into the canonical AGENTS/<tgt>), creates
-sub-repo. Fully idempotent: a second run produces no output and no new
+AGENTS/devlogs/, and wires docs/superpowers/{plans,specs} symlinks back to
-commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
+them. Adds managed paths to .gitignore and auto-commits every change inside
--plugins re-runs only the plugin-directory wiring step. Called
+the AGENTS/ sub-repo; pulls first when the sub-repo has an upstream.
-automatically by the claude and agy wrappers on every invocation.
+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
@@ -961,17 +961,30 @@ agy resume</code></pre>
 Runs the antigravity-ide editor with warnings filtered.</code></pre>
 <h3 data-number="9.12.3" id="agents-init">agents-init</h3>
 <pre><code>Synopsis:  agents-init [--agents | --plugins]
-Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
+Scaffold an AGENTS/ sub-repository for tracking agent specs, plans, specs,
-directories. Creates AGENTS/ as a standalone git repo, initializes
+and dev logs. Creates AGENTS/ as a standalone git repo, moves any existing
-standard plugin subdirectories (superpowers/, plans/, specs/), moves any
+AGENTS.md into it, and replaces it with a relative symlink (plus
-existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
+CLAUDE.md -&gt; AGENTS/AGENTS.md so Claude Code picks up the shared agent
-them with relative symlinks. Also adds CLAUDE.md -&gt; AGENTS/AGENTS.md so
+instructions). Consolidates plans/ and specs/ directly under AGENTS/
-Claude Code picks up the shared agent instructions. Adds all managed
+(merging any legacy docs/plans, docs/superpowers/plans, or old
-paths to .gitignore and auto-commits every change inside the AGENTS/
+AGENTS/plugins/ locations into the canonical AGENTS/&lt;tgt&gt;), creates
-sub-repo. Fully idempotent: a second run produces no output and no new
+AGENTS/devlogs/, and wires docs/superpowers/{plans,specs} symlinks back to
-commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
+them. Adds managed paths to .gitignore and auto-commits every change inside
--plugins re-runs only the plugin-directory wiring step. Called
+the AGENTS/ sub-repo; pulls first when the sub-repo has an upstream.
-automatically by the claude and agy wrappers on every invocation.
+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 &quot;(vX.Y.Z)&quot; 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
@@ -620,17 +620,30 @@
 ### agents-init
    Synopsis:  agents-init [--agents | --plugins]
-    Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
+    Scaffold an AGENTS/ sub-repository for tracking agent specs, plans, specs,
-    directories. Creates AGENTS/ as a standalone git repo, initializes
+    and dev logs. Creates AGENTS/ as a standalone git repo, moves any existing
-    standard plugin subdirectories (superpowers/, plans/, specs/), moves any
+    AGENTS.md into it, and replaces it with a relative symlink (plus
-    existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
+    CLAUDE.md -> AGENTS/AGENTS.md so Claude Code picks up the shared agent
-    them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so
+    instructions). Consolidates plans/ and specs/ directly under AGENTS/
-    Claude Code picks up the shared agent instructions. Adds all managed
+    (merging any legacy docs/plans, docs/superpowers/plans, or old
-    paths to .gitignore and auto-commits every change inside the AGENTS/
+    AGENTS/plugins/ locations into the canonical AGENTS/<tgt>), creates
-    sub-repo. Fully idempotent: a second run produces no output and no new
+    AGENTS/devlogs/, and wires docs/superpowers/{plans,specs} symlinks back to
-    commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
+    them. Adds managed paths to .gitignore and auto-commits every change inside
-    --plugins re-runs only the plugin-directory wiring step. Called
+    the AGENTS/ sub-repo; pulls first when the sub-repo has an upstream.
-    automatically by the claude and agy wrappers on every invocation.
+    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