feat(packs): pack management and version-driven ref resolution

.afx.yaml

@@ -1,5 +1,5 @@
 # AFX dogfooding — using AFX to develop AFX
-version: "1.0"
+version: "feature/pack"
 
 paths:
   specs: "docs/specs"
@@ -37,3 +37,5 @@ ai_attribution:
 # No source code — these don't apply for a docs/tooling repo
 require_see_links: []
 scan_for_orphans: []
+
+packs:

.afx.yaml.template

@@ -2,7 +2,9 @@
 # Copy this file to .afx.yaml in your project root and customize.
 # See: docs/agenticflowx/agenticflowx.md
 
-version: '1.0'
+# AFX version — controls which branch/tag install.sh and pack index are fetched from.
+# Accepts: semver (e.g. '1.5.3' → tag v1.5.3), branch name, or 'main'.
+version: 'main'
 
 # ─────────────────────────────────────────────────────────────────────────────
 # Paths
@@ -97,3 +99,16 @@ scan_for_orphans:
 templates:
   location: 'docs/agenticflowx/templates'         # Path to AFX templates folder
   default: 'default'                     # Template used by /afx:init feature
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Packs — Managed by install.sh, do not edit manually
+# ─────────────────────────────────────────────────────────────────────────────
+# Packs are installed, enabled, disabled, and removed via install.sh.
+# Each entry tracks the pack name, status, installed ref, and disabled items.
+# Example:
+#   packs:
+#     - name: afx-pack-qa
+#       status: enabled
+#       installed_ref: main
+#       disabled_items: []
+packs: []

.agent/skills/afx-check/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-check
+description: Quality verification and compliance checking for AgenticFlowX.
+---
+
+# AFX check
+
+Use this skill when the user requests:
+
+- `afx-check`
+- `/afx:check`
+- AFX check subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-check.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:check` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-context/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-context
+description: Session Context protocol for seamless context transfer between AI sessions.
+---
+
+# AFX context
+
+Use this skill when the user requests:
+
+- `afx-context`
+- `/afx:context`
+- AFX context subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-context.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:context` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-dev/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-dev
+description: Development actions with AFX traceability.
+---
+
+# AFX dev
+
+Use this skill when the user requests:
+
+- `afx-dev`
+- `/afx:dev`
+- AFX dev subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-dev.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:dev` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-discover/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-discover
+description: Discover what exists in your project - infrastructure scripts, automation tools, deployment workflows, and development capabilities.
+---
+
+# AFX discover
+
+Use this skill when the user requests:
+
+- `afx-discover`
+- `/afx:discover`
+- AFX discover subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-discover.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:discover` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-help/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-help
+description: AFX (AgenticFlowX) command reference.
+---
+
+# AFX help
+
+Use this skill when the user requests:
+
+- `afx-help`
+- `/afx:help`
+- AFX help subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-help.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:help` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-init/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-init
+description: Feature spec scaffolding for AgenticFlowX projects.
+---
+
+# AFX init
+
+Use this skill when the user requests:
+
+- `afx-init`
+- `/afx:init`
+- AFX init subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-init.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:init` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-next/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-next
+description: The "Golden Thread" command. Intelligently analyzes your current context (git state, active tasks, session history) and tells you exactly what to do next.
+---
+
+# AFX next
+
+Use this skill when the user requests:
+
+- `afx-next`
+- `/afx:next`
+- AFX next subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-next.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:next` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-report/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-report
+description: Traceability metrics and project health reporting for AgenticFlowX.
+---
+
+# AFX report
+
+Use this skill when the user requests:
+
+- `afx-report`
+- `/afx:report`
+- AFX report subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-report.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:report` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-session/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-session
+description: Session discussion capture and recall for multi-agent workflows.
+---
+
+# AFX session
+
+Use this skill when the user requests:
+
+- `afx-session`
+- `/afx:session`
+- AFX session subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-session.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:session` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-spec/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-spec
+description: Specification management, navigation, review, and approval for spec-centric workflows.
+---
+
+# AFX spec
+
+Use this skill when the user requests:
+
+- `afx-spec`
+- `/afx:spec`
+- AFX spec subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-spec.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:spec` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.

.agent/skills/afx-task/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: afx-task
+description: Verify and summarize task implementation status.
+---
+
+# AFX task
+
+Use this skill when the user requests:
+
+- `afx-task`
+- `/afx:task`
+- AFX task subcommands in natural language
+
+## Source of Truth
+
+Follow the canonical command spec in:
+
+- `.claude/commands/afx-task.md`
+
+Do not re-invent workflow steps. Read the command file and execute it faithfully using available tools.
+
+## Execution Rules
+
+1. Read `.afx.yaml` if present; otherwise use defaults described in the command spec.
+2. Execute only the requested subcommand(s).
+3. Preserve AFX traceability requirements (`@see`, task/session updates, gates) exactly as defined.
+4. End with ranked next-command suggestions matching the command spec.
+
+## Compatibility Note
+
+`/afx:task` is a Claude slash command name. In Antigravity, interpret it as an instruction to run the equivalent AFX workflow via this skill.