thevoidforge-methodology 23.7.1 → 23.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/.claude/commands/ai.md +6 -4
  2. package/.claude/commands/architect.md +6 -4
  3. package/.claude/commands/assemble.md +6 -4
  4. package/.claude/commands/assess.md +6 -4
  5. package/.claude/commands/build.md +6 -4
  6. package/.claude/commands/campaign.md +6 -4
  7. package/.claude/commands/deploy.md +6 -4
  8. package/.claude/commands/devops.md +6 -4
  9. package/.claude/commands/gauntlet.md +6 -4
  10. package/.claude/commands/qa.md +6 -4
  11. package/.claude/commands/review.md +6 -4
  12. package/.claude/commands/security.md +6 -4
  13. package/.claude/commands/test.md +6 -4
  14. package/.claude/commands/ux.md +6 -4
  15. package/CHANGELOG.md +7 -0
  16. package/VERSION.md +2 -1
  17. package/package.json +1 -1
package/.claude/commands/ai.md CHANGED
@@ -17,13 +17,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
17
17
 
18
18
  ## Silver Surfer Pre-Scan (ADR-048)
19
19
 
20
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
20
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
21
21
 
22
- **Prompt the Surfer with:** "Command: /ai. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
22
+ **How to launch:** Use the Agent tool with these exact parameters:
23
+ - `description`: "Silver Surfer roster scan"
24
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /ai. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
23
25
 
24
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
26
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
25
27
 
26
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
28
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
27
29
  **`--light`** — skip the Surfer, use only hardcoded roster below.
28
30
  **`--solo`** — skip Surfer and all sub-agents, lead only.
29
31
 
package/.claude/commands/architect.md CHANGED
@@ -12,13 +12,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
12
12
 
13
13
  ## Silver Surfer Pre-Scan (ADR-048)
14
14
 
15
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
15
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
16
16
 
17
- **Prompt the Surfer with:** "Command: /architect. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
17
+ **How to launch:** Use the Agent tool with these exact parameters:
18
+ - `description`: "Silver Surfer roster scan"
19
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /architect. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
18
20
 
19
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
21
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
20
22
 
21
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
23
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
22
24
  **`--light`** — skip the Surfer, use only hardcoded roster below.
23
25
  **`--solo`** — skip Surfer and all sub-agents, lead only.
24
26
 
package/.claude/commands/assemble.md CHANGED
@@ -15,13 +15,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
15
15
 
16
16
  ## Silver Surfer Pre-Scan (ADR-048)
17
17
 
18
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
18
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
19
19
 
20
- **Prompt the Surfer with:** "Command: /assemble. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
20
+ **How to launch:** Use the Agent tool with these exact parameters:
21
+ - `description`: "Silver Surfer roster scan"
22
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /assemble. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
21
23
 
22
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
24
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
23
25
 
24
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
26
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
25
27
  **`--light`** — skip the Surfer, use only hardcoded roster below.
26
28
  **`--solo`** — skip Surfer and all sub-agents, lead only.
27
29
 
package/.claude/commands/assess.md CHANGED
@@ -4,13 +4,15 @@ Evaluate an existing codebase before a rebuild, migration, or VoidForge onboardi
4
4
 
5
5
  ## Silver Surfer Pre-Scan (ADR-048)
6
6
 
7
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
7
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
8
8
 
9
- **Prompt the Surfer with:** "Command: /assess. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
9
+ **How to launch:** Use the Agent tool with these exact parameters:
10
+ - `description`: "Silver Surfer roster scan"
11
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /assess. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
10
12
 
11
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
13
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
12
14
 
13
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
15
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
14
16
  **`--light`** — skip the Surfer, use only hardcoded roster below.
15
17
  **`--solo`** — skip Surfer and all sub-agents, lead only.
16
18
 
package/.claude/commands/build.md CHANGED
@@ -12,13 +12,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
12
12
 
13
13
  ## Silver Surfer Pre-Scan (ADR-048)
14
14
 
15
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
15
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
16
16
 
17
- **Prompt the Surfer with:** "Command: /build. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
17
+ **How to launch:** Use the Agent tool with these exact parameters:
18
+ - `description`: "Silver Surfer roster scan"
19
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /build. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
18
20
 
19
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
21
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
20
22
 
21
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
23
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
22
24
  **`--light`** — skip the Surfer, use only hardcoded roster below.
23
25
  **`--solo`** — skip Surfer and all sub-agents, lead only.
24
26
 
package/.claude/commands/campaign.md CHANGED
@@ -55,13 +55,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
55
55
 
56
56
  ## Silver Surfer Pre-Scan (ADR-048)
57
57
 
58
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
58
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
59
59
 
60
- **Prompt the Surfer with:** "Command: /campaign. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
60
+ **How to launch:** Use the Agent tool with these exact parameters:
61
+ - `description`: "Silver Surfer roster scan"
62
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /campaign. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
61
63
 
62
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
64
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
63
65
 
64
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
66
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
65
67
  **`--light`** — skip the Surfer, use only hardcoded roster below.
66
68
  **`--solo`** — skip Surfer and all sub-agents, lead only.
67
69
 
package/.claude/commands/deploy.md CHANGED
@@ -6,13 +6,15 @@ Read `/docs/methods/DEVOPS_ENGINEER.md` for operating rules (see "Deploy Automat
6
6
 
7
7
  ## Silver Surfer Pre-Scan (ADR-048)
8
8
 
9
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
9
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
10
10
 
11
- **Prompt the Surfer with:** "Command: /deploy. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
11
+ **How to launch:** Use the Agent tool with these exact parameters:
12
+ - `description`: "Silver Surfer roster scan"
13
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /deploy. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
12
14
 
13
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
15
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
14
16
 
15
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
17
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
16
18
  **`--light`** — skip the Surfer, use only hardcoded roster below.
17
19
  **`--solo`** — skip Surfer and all sub-agents, lead only.
18
20
 
package/.claude/commands/devops.md CHANGED
@@ -13,13 +13,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
13
13
 
14
14
  ## Silver Surfer Pre-Scan (ADR-048)
15
15
 
16
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
16
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
17
17
 
18
- **Prompt the Surfer with:** "Command: /devops. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
18
+ **How to launch:** Use the Agent tool with these exact parameters:
19
+ - `description`: "Silver Surfer roster scan"
20
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /devops. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
19
21
 
20
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
22
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
21
23
 
22
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
24
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
23
25
  **`--light`** — skip the Surfer, use only hardcoded roster below.
24
26
  **`--solo`** — skip Surfer and all sub-agents, lead only.
25
27
 
package/.claude/commands/gauntlet.md CHANGED
@@ -17,13 +17,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
17
17
 
18
18
  ## Silver Surfer Pre-Scan (ADR-048)
19
19
 
20
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
20
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
21
21
 
22
- **Prompt the Surfer with:** "Command: /gauntlet. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
22
+ **How to launch:** Use the Agent tool with these exact parameters:
23
+ - `description`: "Silver Surfer roster scan"
24
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /gauntlet. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
23
25
 
24
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
26
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
25
27
 
26
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
28
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
27
29
  **`--light`** — skip the Surfer, use only hardcoded roster below.
28
30
  **`--solo`** — skip Surfer and all sub-agents, lead only.
29
31
 
package/.claude/commands/qa.md CHANGED
@@ -12,13 +12,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
12
12
 
13
13
  ## Silver Surfer Pre-Scan (ADR-048)
14
14
 
15
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
15
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
16
16
 
17
- **Prompt the Surfer with:** "Command: /qa. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
17
+ **How to launch:** Use the Agent tool with these exact parameters:
18
+ - `description`: "Silver Surfer roster scan"
19
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /qa. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
18
20
 
19
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
21
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
20
22
 
21
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
23
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
22
24
  **`--light`** — skip the Surfer, use only hardcoded roster below.
23
25
  **`--solo`** — skip Surfer and all sub-agents, lead only.
24
26
 
package/.claude/commands/review.md CHANGED
@@ -10,13 +10,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
10
10
 
11
11
  ## Silver Surfer Pre-Scan (ADR-048)
12
12
 
13
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
13
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
14
14
 
15
- **Prompt the Surfer with:** "Command: /review. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
15
+ **How to launch:** Use the Agent tool with these exact parameters:
16
+ - `description`: "Silver Surfer roster scan"
17
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /review. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
16
18
 
17
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
19
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
18
20
 
19
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
21
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
20
22
  **`--light`** — skip the Surfer, use only hardcoded roster below.
21
23
  **`--solo`** — skip Surfer and all sub-agents, lead only.
22
24
 
package/.claude/commands/security.md CHANGED
@@ -10,13 +10,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
10
10
 
11
11
  ## Silver Surfer Pre-Scan (ADR-048)
12
12
 
13
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
13
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
14
14
 
15
- **Prompt the Surfer with:** "Command: /security. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
15
+ **How to launch:** Use the Agent tool with these exact parameters:
16
+ - `description`: "Silver Surfer roster scan"
17
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /security. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
16
18
 
17
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
19
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
18
20
 
19
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
21
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
20
22
  **`--light`** — skip the Surfer, use only hardcoded roster below.
21
23
  **`--solo`** — skip Surfer and all sub-agents, lead only.
22
24
 
package/.claude/commands/test.md CHANGED
@@ -15,13 +15,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
15
15
 
16
16
  ## Silver Surfer Pre-Scan (ADR-048)
17
17
 
18
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
18
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
19
19
 
20
- **Prompt the Surfer with:** "Command: /test. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
20
+ **How to launch:** Use the Agent tool with these exact parameters:
21
+ - `description`: "Silver Surfer roster scan"
22
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /test. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
21
23
 
22
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
24
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
23
25
 
24
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
26
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
25
27
  **`--light`** — skip the Surfer, use only hardcoded roster below.
26
28
  **`--solo`** — skip Surfer and all sub-agents, lead only.
27
29
 
package/.claude/commands/ux.md CHANGED
@@ -10,13 +10,15 @@ Opus scans `git diff --stat` and matches changed files against the `description`
10
10
 
11
11
  ## Silver Surfer Pre-Scan (ADR-048)
12
12
 
13
- **MANDATORY.** Before deploying any domain agents, launch **Silver Surfer** `subagent_type: Silver Surfer` as a sub-agent. The Surfer reads all agent definitions, assesses the codebase, and returns the optimal roster for this command. This is not optional — skipping the Surfer means the command uses a generic team instead of one tailored to the codebase.
13
+ **MANDATORY.** Before deploying any domain agents, launch the Silver Surfer as a sub-agent to select the optimal roster for this command. **Do NOT skip this step.**
14
14
 
15
- **Prompt the Surfer with:** "Command: /ux. User args: <user's arguments>. Focus: <focus if provided, otherwise 'none'>. Select the optimal agent roster."
15
+ **How to launch:** Use the Agent tool with these exact parameters:
16
+ - `description`: "Silver Surfer roster scan"
17
+ - `prompt`: "You are the Silver Surfer, Herald of Galactus. Read your instructions from .claude/agents/silver-surfer-herald.md, then execute your task. Command: /ux. User args: <ARGS>. Focus: <FOCUS or 'none'>. Scan the .claude/agents/ directory, read agent descriptions and tags, and return the optimal roster for this command on this codebase."
16
18
 
17
- **Merge the Surfer's roster** with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
19
+ **After the Surfer returns**, merge its roster with this command's hardcoded lead agents below. Leads are non-negotiable; the Surfer adds specialists.
18
20
 
19
- **`--focus "topic"`** — pass to the Surfer as the focus bias.
21
+ **`--focus "topic"`** — include in the Surfer's prompt as the focus bias.
20
22
  **`--light`** — skip the Surfer, use only hardcoded roster below.
21
23
  **`--solo`** — skip Surfer and all sub-agents, lead only.
22
24
 
package/CHANGELOG.md CHANGED
@@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
6
6
 
7
7
  ---
8
8
 
9
+ ## [23.7.2] - 2026-04-12
10
+
11
+ ### Fixed
12
+ - **Silver Surfer invocation made explicit and guaranteed** — commands now provide exact Agent tool parameters (`description` + `prompt` with `.claude/agents/silver-surfer-herald.md` read instruction) instead of the non-functional `subagent_type: Silver Surfer`. Works 100% of the time in every Claude Code environment.
13
+
14
+ ---
15
+
9
16
  ## [23.7.1] - 2026-04-12
10
17
 
11
18
  ### Changed
package/VERSION.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Version
2
2
 
3
- **Current:** 23.7.1
3
+ **Current:** 23.7.2
4
4
 
5
5
  ## Versioning Scheme
6
6
 
@@ -14,6 +14,7 @@ This project uses [Semantic Versioning](https://semver.org/):
14
14
 
15
15
  | Version | Date | Summary |
16
16
  |---------|------|---------|
17
+ | 23.7.2 | 2026-04-12 | Silver Surfer explicit Agent tool invocation — guaranteed to work in every environment |
17
18
  | 23.7.1 | 2026-04-12 | Silver Surfer launches as real Agent sub-process (subagent_type: Silver Surfer), not CLI shell-out. Mandatory on every command. |
18
19
  | 23.7.0 | 2026-04-12 | The Decount — eliminate hardcoded agent counts from 30+ files. Single source of truth: AGENT_CLASSIFICATION.md. |
19
20
  | 23.6.1 | 2026-04-12 | Gauntlet fix: 30+ stale "263 agents" → 264 across commands, methods, docs |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "thevoidforge-methodology",
3
- "version": "23.7.1",
3
+ "version": "23.7.2",
4
4
  "description": "VoidForge methodology — agents, commands, methods, patterns.",
5
5
  "license": "MIT",
6
6
  "files": [