@agents-inc/cli 0.75.1 → 0.76.0

package/dist/src/agents/_templates/methodologies/success-criteria.liquid

@@ -0,0 +1,111 @@
+<success_criteria_template>
+
+Every task needs explicit, measurable criteria that define "done." This prevents agents from stopping too early or continuing unnecessarily.
+
+Success criteria must be:
+
+1. **Specific** - No ambiguity about what "done" means
+2. **Measurable** - Can verify with tests, checks, or observations
+3. **Achievable** - Within scope of the task
+4. **Verifiable** - Can provide evidence of completion
+
+## Template Structure
+
+Use this structure when defining success criteria:
+
+```xml
+<success_criteria>
+Your implementation must meet these criteria:
+
+**Functional Requirements:**
+1. [Specific behavior that must work]
+2. [Another specific behavior]
+
+**Technical Requirements:**
+3. All existing tests continue to pass
+4. New functionality is covered by tests with >80% coverage
+5. Code follows existing patterns in [specific files]
+
+**Constraints:**
+6. No new dependencies are introduced
+7. Changes are limited to [specific files/modules]
+8. Performance is equivalent to or better than [baseline]
+
+**After Implementation:**
+- Run the test suite and report results
+- Verify each criterion is met
+- Report any criteria that aren't met and explain why
+</success_criteria>
+```
+
+</success_criteria_template>
+
+### Good vs. Bad Success Criteria
+
+**Bad (vague, unmeasurable):**
+
+```
+- Feature works well
+- Code is clean
+- No bugs
+- Good user experience
+```
+
+**Problem:** No specific, measurable targets. What does "works" mean? Which tests? How do you know it's "clean"?
+
+**Good (specific, measurable):**
+
+```
+1. User can click "Edit Profile" button and modal appears
+2. Modal displays current values (name, email, bio)
+3. Email validation prevents invalid formats (test@test passes, test fails)
+4. Form submission updates user record in database
+5. Success message displays after save
+6. All tests in profile-editor.test.ts pass
+7. New tests cover: happy path, validation errors, network errors
+8. No modifications to authentication system (auth.py unchanged)
+9. Follows form pattern from SettingsForm.tsx (lines 45-89)
+```
+
+**Why better:** Each criterion can be verified with a simple yes/no check.
+
+---
+
+<verification_process>
+
+### Verification Process
+
+After completing work, systematically verify:
+
+```xml
+<verification_checklist>
+For each success criterion:
+1. State the criterion
+2. Describe how you verified it
+3. Provide evidence (test output, behavior observed, file comparison)
+4. Mark as PASS (met) or FAIL (not met)
+
+If any criterion is FAIL:
+- Explain why it's not met
+- Indicate if it's a blocker or acceptable deviation
+- Suggest what's needed to meet it
+</verification_checklist>
+```
+
+**Example Verification:**
+
+```
+Criterion 1: User can click "Edit Profile" and see modal with current values
+PASS Verified: Tested in browser, modal opens with user's current name, email, bio
+Evidence: Screenshot attached, manual test passed
+
+Criterion 5: All tests in profile-editor.test.ts pass
+PASS Verified: Ran `npm test profile-editor.test.ts`
+Evidence: All 12 tests passing, 0 failures
+
+Criterion 7: No modifications to authentication system
+PASS Verified: git diff shows no changes to auth.py or related files
+Evidence: `git diff main...feature-branch -- auth.py` returns empty
+```
+
+</verification_process>

package/dist/src/agents/_templates/methodologies/write-verification.liquid

@@ -0,0 +1,43 @@
+<write_verification_protocol>
+
+**CRITICAL: Never report success without verifying your work was actually saved.**
+
+### Why This Exists
+
+Agents can:
+
+1. Analyze what needs to change
+2. Generate correct content
+3. Plan the edits
+4. **Fail to actually execute the Write/Edit operations**
+5. **Report success based on the plan, not reality**
+
+This causes downstream failures that are hard to debug because the agent reported success.
+
+### Mandatory Verification Steps
+
+**After completing ANY file edits, you MUST:**
+
+1. **Re-read the file(s) you just edited** using the Read tool
+2. **Verify your changes exist in the file:**
+   - For new content: Confirm the new text/code is present
+   - For edits: Confirm the old content was replaced
+   - For structural changes: Confirm the structure is correct
+3. **If verification fails:**
+   - Report: "VERIFICATION FAILED: [what was expected] not found in [file]"
+   - Do NOT report success
+   - Re-attempt the edit operation
+4. **Only report success AFTER verification passes**
+
+### Verification Checklist
+
+Include this in your final validation:
+
+```
+**Write Verification:**
+- [ ] Re-read file(s) after completing edits
+- [ ] Verified expected changes exist in file
+- [ ] Only reporting success after verification passed
+```
+
+</write_verification_protocol>

package/dist/src/agents/meta/agent-summoner/workflow.md

@@ -356,8 +356,8 @@ Skills use a three-file structure in domain-based directories:
 
 - **Location:** `.claude/skills/{domain}-{category}-{technology}/`
 - **Files:** `SKILL.md`, `metadata.yaml`, `reference.md` (optional)
-- **Domains:** `web-`, `api-`, `cli-`, `meta-`
-- **Examples:** `web-framework-react/`, `api-database-drizzle/`, `meta-methodology-investigation-requirements/`
+- **Domains:** `web-`, `api-`, `cli-`, `shared-`, `mobile-`
+- **Examples:** `web-framework-react/`, `api-database-drizzle/`, `shared-meta-reviewing/`
 
 ---
 

package/dist/src/agents/meta/skill-summoner/workflow.md

@@ -762,8 +762,8 @@ For complex skill creation/improvement tasks spanning multiple conversation turn
 - [ ] Has `<patterns>` section with Core Patterns with embedded good/bad examples
 - [ ] Has `<performance>` section for optimization patterns (OPTIONAL - include if relevant)
 - [ ] Has `<decision_framework>` section
-- [ ] Has `<integration>` section for stack integration guidance (OPTIONAL - include if meaningful)
-- [ ] Has `<red_flags>` section with "Gotchas & Edge Cases" subsection
+- [ ] Has `<integration>` section ONLY if skill has its own ecosystem packages to list (OPTIONAL — must NOT name external tools from other domains per atomicity bible)
+- [ ] Has `<red_flags>` section with "Gotchas & Edge Cases" subsection (REQUIRED in SKILL.md, not just reference.md)
 
 **Example Quality:**
 - [ ] Good/Bad pairs embedded in each Core Pattern
@@ -774,6 +774,26 @@ For complex skill creation/improvement tasks spanning multiple conversation turn
 - [ ] Named exports used (no default exports)
 - [ ] Patterns use `#### SubsectionName` headers as needed
 
+**Atomicity (REQUIRED — most common source of skill defects):**
+- [ ] Grep for `NEXT_PUBLIC_`, `@repo/`, `@/lib/` — replace with generic names
+- [ ] Grep for external tool names from other domains (React Query, Zustand, SCSS, MSW, Vitest, lucide-react, Hono, Drizzle)
+- [ ] `<integration>` section (if present) names ONLY the skill's own ecosystem packages, not external tools
+- [ ] "When NOT to use" does NOT name specific competing tools by name
+- [ ] Decision trees end within this skill's domain (no "→ Use React Query" exits)
+- [ ] Critical requirements actually relate to THIS technology (no template contamination — e.g. `runInAction()` in a non-MobX skill)
+
+**File Structure:**
+- [ ] `examples/core.md` exists (ALWAYS required — rename the most fundamental file if needed)
+- [ ] `<red_flags>` section exists in SKILL.md (not just in reference.md)
+- [ ] SKILL.md is the decision layer (~500 lines max): brief 3-10 line snippets + links to example files, NOT full implementations
+- [ ] No content duplicated between SKILL.md and example files
+- [ ] No content duplicated between SKILL.md and reference.md
+
+**API Accuracy:**
+- [ ] For each code example's main API call, verified the function signature against official docs
+- [ ] Verified which package an import comes from (not just the function name)
+- [ ] Checked npm for the latest stable version — updated version claims if stale
+
 **Write Verification:**
 - [ ] Re-read the files after completing edits
 - [ ] Verified all required files exist
@@ -818,6 +838,25 @@ For complex skill creation/improvement tasks spanning multiple conversation turn
 - [ ] Any removed content was ONLY removed because it was redundant or violated conventions
 - [ ] Added prompt-bible structure AROUND existing content, not replacing it
 
+**Atomicity (REQUIRED — most common source of skill defects):**
+- [ ] Grep for `NEXT_PUBLIC_`, `@repo/`, `@/lib/` — replace with generic names
+- [ ] Grep for external tool names from other domains (React Query, Zustand, SCSS, MSW, Vitest, lucide-react, Hono, Drizzle)
+- [ ] `<integration>` section (if present) names ONLY the skill's own ecosystem packages, not external tools
+- [ ] "When NOT to use" does NOT name specific competing tools by name
+- [ ] Decision trees end within this skill's domain
+- [ ] Critical requirements actually relate to THIS technology (no template contamination)
+
+**File Structure:**
+- [ ] `examples/core.md` exists (ALWAYS required)
+- [ ] `<red_flags>` section exists in SKILL.md
+- [ ] SKILL.md serves as decision layer (~500 lines max): brief snippets + links, NOT full implementations
+- [ ] No content duplicated between SKILL.md, reference.md, and example files
+
+**API Accuracy:**
+- [ ] For each code example's main API call, verified the function signature against official docs
+- [ ] Verified which package an import comes from (not just the function name)
+- [ ] Checked npm for the latest stable version — updated version claims if stale
+
 **Write Verification:**
 - [ ] Re-read the files after completing edits
 - [ ] Verified changes were actually written
@@ -847,10 +886,16 @@ For complex skill creation/improvement tasks spanning multiple conversation turn
 
 **Completeness:**
 - [ ] All major patterns covered
-- [ ] Integration guidance provided (if meaningful)
+- [ ] Integration guidance (if present) is generic — names only skill's own packages, not external tools
 - [ ] Testing approaches included (if applicable)
 - [ ] Performance section addresses optimization (if relevant)
 
+**Content Ownership (no duplication):**
+- [ ] SKILL.md owns: decisions, philosophy, red flags, brief pattern snippets
+- [ ] Example files own: full code implementations (SKILL.md links to them, doesn't duplicate)
+- [ ] reference.md owns: quick-lookup tables, checklists, API reference
+- [ ] Anti-patterns appear in ONE location (SKILL.md red flags OR reference.md, not both)
+
 **Currency:**
 - [ ] No deprecated patterns recommended
 - [ ] Version-specific content accurate

package/dist/stores/wizard-store.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   useWizardStore
-} from "../chunk-BVSWWBPE.js";
-import "../chunk-5BGBH3KD.js";
-import "../chunk-XHTN56UT.js";
-import "../chunk-HKIQA4F6.js";
-import "../chunk-6C66NL4X.js";
-import "../chunk-SYGXJBG6.js";
-import "../chunk-EGMQ3SXN.js";
-import "../chunk-PSU42CXK.js";
+} from "../chunk-PRG7PKZM.js";
+import "../chunk-WS3TL2AO.js";
+import "../chunk-I534EWJQ.js";
+import "../chunk-JWMYAJHD.js";
+import "../chunk-WN2TUP4M.js";
+import "../chunk-Q4PJSAMP.js";
+import "../chunk-FMYAYX6W.js";
+import "../chunk-7XUKTYVD.js";
 import "../chunk-DHET7RCE.js";
 export {
   useWizardStore

package/dist/stores/wizard-store.test.js

@@ -9,12 +9,12 @@ import {
   ALL_SKILLS_WEB_FRAMEWORK_MATRIX,
   ALL_SKILLS_WEB_PAIR_CATEGORIES_MATRIX,
   REACT_HONO_FRAMEWORK_API_MATRIX
-} from "../chunk-UQKCYLOA.js";
-import "../chunk-TYM4D3OF.js";
+} from "../chunk-6F3CZLD6.js";
+import "../chunk-M4ZDKHJV.js";
 import {
   SKILLS,
   createMockMatrix
-} from "../chunk-JGSPESM3.js";
+} from "../chunk-WMMU5FOO.js";
 import {
   beforeEach,
   describe,
@@ -23,17 +23,17 @@ import {
 } from "../chunk-XY3XDVMI.js";
 import {
   useWizardStore
-} from "../chunk-BVSWWBPE.js";
-import "../chunk-5BGBH3KD.js";
-import "../chunk-XHTN56UT.js";
+} from "../chunk-PRG7PKZM.js";
+import "../chunk-WS3TL2AO.js";
+import "../chunk-I534EWJQ.js";
 import {
   initializeMatrix,
   typedKeys
-} from "../chunk-HKIQA4F6.js";
-import "../chunk-6C66NL4X.js";
-import "../chunk-SYGXJBG6.js";
-import "../chunk-EGMQ3SXN.js";
-import "../chunk-PSU42CXK.js";
+} from "../chunk-JWMYAJHD.js";
+import "../chunk-WN2TUP4M.js";
+import "../chunk-Q4PJSAMP.js";
+import "../chunk-FMYAYX6W.js";
+import "../chunk-7XUKTYVD.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";
@@ -720,7 +720,7 @@ describe("WizardStore", () => {
       const store = useWizardStore.getState();
       const stack = {
         agents: {
-          misc: { "shared-methodology": [sa("meta-methodology-vitest")] }
+          misc: { "shared-meta": [sa("meta-methodology-vitest")] }
         }
       };
       initializeMatrix(ALL_SKILLS_METHODOLOGY_BARE_MATRIX);
@@ -733,10 +733,10 @@ describe("WizardStore", () => {
       const stack = {
         agents: {
           "pattern-scout": {
-            "shared-methodology": [
-              sa("meta-methodology-investigation-requirements", true),
-              sa("meta-methodology-anti-over-engineering", true),
-              sa("meta-methodology-success-criteria", true)
+            "shared-meta": [
+              sa("shared-meta-research-methodology", true),
+              sa("shared-meta-reviewing", true),
+              sa("shared-meta-cli-reviewing", true)
             ]
           }
         }
@@ -744,10 +744,10 @@ describe("WizardStore", () => {
       initializeMatrix(ALL_SKILLS_METHODOLOGY_MATRIX);
       store.populateFromStack(stack);
       const { domainSelections } = useWizardStore.getState();
-      globalExpect(domainSelections.shared["shared-methodology"]).toEqual([
-        "meta-methodology-investigation-requirements",
-        "meta-methodology-anti-over-engineering",
-        "meta-methodology-success-criteria"
+      globalExpect(domainSelections.shared["shared-meta"]).toEqual([
+        "shared-meta-research-methodology",
+        "shared-meta-reviewing",
+        "shared-meta-cli-reviewing"
       ]);
     });
     it("should handle single-element and multi-element arrays across agents", () => {
@@ -756,9 +756,9 @@ describe("WizardStore", () => {
         agents: {
           web: {
             "web-framework": [sa("web-framework-react", true)],
-            "shared-methodology": [
-              sa("meta-methodology-investigation-requirements", true),
-              sa("meta-methodology-anti-over-engineering", true)
+            "shared-meta": [
+              sa("shared-meta-research-methodology", true),
+              sa("shared-meta-reviewing", true)
             ]
           },
           api: { "api-api": [sa("api-framework-hono", true)] }
@@ -768,9 +768,9 @@ describe("WizardStore", () => {
       store.populateFromStack(stack);
       const { domainSelections } = useWizardStore.getState();
       globalExpect(domainSelections.web["web-framework"]).toEqual(["web-framework-react"]);
-      globalExpect(domainSelections.shared["shared-methodology"]).toEqual([
-        "meta-methodology-investigation-requirements",
-        "meta-methodology-anti-over-engineering"
+      globalExpect(domainSelections.shared["shared-meta"]).toEqual([
+        "shared-meta-research-methodology",
+        "shared-meta-reviewing"
       ]);
       globalExpect(domainSelections.api["api-api"]).toEqual(["api-framework-hono"]);
     });
@@ -779,15 +779,15 @@ describe("WizardStore", () => {
       const stack = {
         agents: {
           agent1: {
-            "shared-methodology": [
-              sa("meta-methodology-investigation-requirements", true),
-              sa("meta-methodology-anti-over-engineering", true)
+            "shared-meta": [
+              sa("shared-meta-research-methodology", true),
+              sa("shared-meta-reviewing", true)
             ]
           },
           agent2: {
-            "shared-methodology": [
-              sa("meta-methodology-anti-over-engineering", true),
-              sa("meta-methodology-success-criteria", true)
+            "shared-meta": [
+              sa("shared-meta-reviewing", true),
+              sa("shared-meta-cli-reviewing", true)
             ]
           }
         }
@@ -795,10 +795,10 @@ describe("WizardStore", () => {
       initializeMatrix(ALL_SKILLS_METHODOLOGY_MATRIX);
       store.populateFromStack(stack);
       const { domainSelections } = useWizardStore.getState();
-      globalExpect(domainSelections.shared["shared-methodology"]).toEqual([
-        "meta-methodology-investigation-requirements",
-        "meta-methodology-anti-over-engineering",
-        "meta-methodology-success-criteria"
+      globalExpect(domainSelections.shared["shared-meta"]).toEqual([
+        "shared-meta-research-methodology",
+        "shared-meta-reviewing",
+        "shared-meta-cli-reviewing"
       ]);
     });
   });