thevoidforge-methodology 23.8.0 → 23.8.1
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.
- package/.claude/agents/silver-surfer-herald.md +2 -1
- package/.claude/commands/ai.md +3 -1
- package/.claude/commands/architect.md +3 -1
- package/.claude/commands/assemble.md +3 -1
- package/.claude/commands/assess.md +3 -1
- package/.claude/commands/build.md +3 -1
- package/.claude/commands/campaign.md +3 -1
- package/.claude/commands/deploy.md +3 -1
- package/.claude/commands/devops.md +3 -1
- package/.claude/commands/gauntlet.md +3 -1
- package/.claude/commands/qa.md +3 -1
- package/.claude/commands/review.md +3 -1
- package/.claude/commands/security.md +3 -1
- package/.claude/commands/test.md +3 -1
- package/.claude/commands/ux.md +3 -1
- package/CHANGELOG.md +7 -0
- package/VERSION.md +2 -1
- package/package.json +1 -1
|
@@ -78,9 +78,10 @@ TOTAL: [count]
|
|
|
78
78
|
|
|
79
79
|
- **Hardcoded counts go stale.** Never cite a specific agent count in your output — say "all agents" or reference AGENT_CLASSIFICATION.md. (v23.7.0 lesson: 30+ files needed updating when one agent was added.)
|
|
80
80
|
- **The command's hardcoded manifest is the floor, not the ceiling.** Your job is to add specialists the command didn't think to include. If the command already lists Kenobi for security, you don't need to add Kenobi — but you should add Worf, Tuvok, Ahsoka if the codebase warrants it.
|
|
81
|
+
- **You MUST be launched. No exceptions.** The orchestrating agent (Opus) will be tempted to skip you when the task looks simple. "4 content-only missions" or "just a text fix" are NOT valid reasons to skip. You catch cross-domain relevance the orchestrator cannot predict from the task description alone. If you are not launched, the command violates protocol. (Field report: voidforge.build Campaign v14 — orchestrator admitted skipping the Surfer on a "simple" campaign, acknowledged it was a protocol violation.)
|
|
81
82
|
|
|
82
83
|
## Required Context
|
|
83
84
|
|
|
84
85
|
- Agent definitions: `.claude/agents/*.md`
|
|
85
86
|
- Agent classification: `docs/AGENT_CLASSIFICATION.md`
|
|
86
|
-
- This agent is launched via
|
|
87
|
+
- This agent is launched via the Agent tool from every major command's Step 0. See any command file's "Silver Surfer Pre-Scan (ADR-048)" section for exact invocation parameters.
|
package/.claude/commands/ai.md
CHANGED
|
@@ -17,7 +17,9 @@ 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.**
|
|
20
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
21
|
+
|
|
22
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
21
23
|
|
|
22
24
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
23
25
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -12,7 +12,9 @@ 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.**
|
|
15
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
16
|
+
|
|
17
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
16
18
|
|
|
17
19
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
18
20
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -15,7 +15,9 @@ 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.**
|
|
18
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
19
|
+
|
|
20
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
19
21
|
|
|
20
22
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
21
23
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -4,7 +4,9 @@ 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.**
|
|
7
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
8
|
+
|
|
9
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
8
10
|
|
|
9
11
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
10
12
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -12,7 +12,9 @@ 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.**
|
|
15
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
16
|
+
|
|
17
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
16
18
|
|
|
17
19
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
18
20
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -55,7 +55,9 @@ 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.**
|
|
58
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
59
|
+
|
|
60
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
59
61
|
|
|
60
62
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
61
63
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -6,7 +6,9 @@ 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.**
|
|
9
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
10
|
+
|
|
11
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
10
12
|
|
|
11
13
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
12
14
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -13,7 +13,9 @@ 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.**
|
|
16
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
17
|
+
|
|
18
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
17
19
|
|
|
18
20
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
19
21
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -17,7 +17,9 @@ 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.**
|
|
20
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
21
|
+
|
|
22
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
21
23
|
|
|
22
24
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
23
25
|
- `description`: "Silver Surfer roster scan"
|
package/.claude/commands/qa.md
CHANGED
|
@@ -12,7 +12,9 @@ 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.**
|
|
15
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
16
|
+
|
|
17
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
16
18
|
|
|
17
19
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
18
20
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -10,7 +10,9 @@ 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.**
|
|
13
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
14
|
+
|
|
15
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
14
16
|
|
|
15
17
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
16
18
|
- `description`: "Silver Surfer roster scan"
|
|
@@ -10,7 +10,9 @@ 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.**
|
|
13
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
14
|
+
|
|
15
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
14
16
|
|
|
15
17
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
16
18
|
- `description`: "Silver Surfer roster scan"
|
package/.claude/commands/test.md
CHANGED
|
@@ -15,7 +15,9 @@ 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.**
|
|
18
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
19
|
+
|
|
20
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
19
21
|
|
|
20
22
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
21
23
|
- `description`: "Silver Surfer roster scan"
|
package/.claude/commands/ux.md
CHANGED
|
@@ -10,7 +10,9 @@ 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.**
|
|
13
|
+
**MANDATORY — NO EXCEPTIONS.** Launch the Silver Surfer before deploying ANY other agents. This is not negotiable, not deferrable, and not skippable regardless of how simple the task appears. "The task is simple" is NOT a valid reason to skip — the Surfer catches cross-domain relevance that you cannot predict. "I already know which agents to use" is NOT a valid reason — the Surfer reads agent definitions you haven't loaded. Skipping the Surfer is a protocol violation equivalent to skipping the Victory Gauntlet. **If you find yourself thinking "I don't need the Surfer for this" — that is exactly when you need it most.**
|
|
14
|
+
|
|
15
|
+
Read the `heralding:` field from `.claude/agents/silver-surfer-herald.md` and announce it before launching.
|
|
14
16
|
|
|
15
17
|
**How to launch:** Use the Agent tool with these exact parameters:
|
|
16
18
|
- `description`: "Silver Surfer roster scan"
|
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.8.1] - 2026-04-12
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
- **Silver Surfer anti-skip enforcement hardened** — "MANDATORY" wasn't strong enough. Commands now say "NO EXCEPTIONS" with pre-emptive rebuttals for every rationalization Claude uses to skip ("task is simple", "I already know which agents"). Equated to Victory Gauntlet violation. Psychological inversion: "If you think you don't need the Surfer — that's exactly when you need it most." Operational learning added to Silver Surfer agent definition with field report evidence.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
9
16
|
## [23.8.0] - 2026-04-12
|
|
10
17
|
|
|
11
18
|
### The Personality (ADR-049)
|
package/VERSION.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Version
|
|
2
2
|
|
|
3
|
-
**Current:** 23.8.
|
|
3
|
+
**Current:** 23.8.1
|
|
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.8.1 | 2026-04-12 | Silver Surfer anti-skip hardening — NO EXCEPTIONS enforcement + field report learning |
|
|
17
18
|
| 23.8.0 | 2026-04-12 | The Personality — heralding one-liners for all 264 agents. Character-authentic announcements on every agent deployment. ADR-049. |
|
|
18
19
|
| 23.7.3 | 2026-04-12 | Cosmic Heraldings — 14 Silver Surfer one-liners announced at random before each roster scan |
|
|
19
20
|
| 23.7.2 | 2026-04-12 | Silver Surfer explicit Agent tool invocation — guaranteed to work in every environment |
|