@crewpilot/agent 2.0.0 → 3.0.0

package/prompts/skills/strategize-solution-design/SKILL.md

@@ -1,118 +1,118 @@
-# Solution Design
-
-> **Pillar**: Strategize | **ID**: `strategize-solution-design`
-
-## Purpose
-
-Structured ideation and trade-off analysis for technical decisions. Transforms vague questions into evaluated options with clear recommendations.
-
-## Activation Triggers
-
-- "brainstorm", "explore options", "what are the approaches", "tradeoffs", "should I use X or Y"
-- Any open-ended technical question with multiple viable paths
-
-## Methodology
-
-### Process Flow
-
-```dot
-digraph solution_design {
-    rankdir=TB;
-    node [shape=box];
-
-    frame [label="Phase 1\nProblem Framing"];
-    options [label="Phase 2\nOption Generation\n(3-4 approaches)"];
-    matrix [label="Phase 3\nTrade-off Matrix"];
-    recommend [label="Phase 4\nRecommendation", shape=diamond, style=filled, fillcolor="#ffcccc"];
-    arch [label="architecture-planner", shape=doublecircle];
-    build [label="feature-builder", shape=doublecircle];
-
-    frame -> options;
-    options -> matrix;
-    matrix -> recommend;
-    recommend -> arch [label="needs detailed design"];
-    recommend -> build [label="ready to implement"];
-    recommend -> options [label="user rejects\nall options"];
-}
-```
-
-### Phase 1 — Problem Framing
-1. Restate the problem in one sentence
-2. Identify constraints: time, team size, existing tech stack, scale requirements
-3. Ask 1-2 clarifying questions ONLY if the problem is genuinely ambiguous
-
-### Phase 2 — Option Generation
-1. Generate 3-4 distinct approaches (configurable via `max_options` in config)
-2. Each option must include:
-   - **Name**: Short memorable label
-   - **Approach**: 2-3 sentence description
-   - **Strengths**: What it does well
-   - **Risks**: What could go wrong
-   - **Effort**: T-shirt size (S/M/L/XL) with justification
-3. Options must be genuinely different — not variations of the same approach
-
-### Phase 3 — Trade-off Matrix
-Build a comparison table:
-
-| Criterion | Option A | Option B | Option C |
-|---|---|---|---|
-| Implementation effort | | | |
-| Maintainability | | | |
-| Performance | | | |
-| Team familiarity | | | |
-
-Rate each cell: `++` (strong), `+` (good), `~` (neutral), `-` (weak), `--` (poor)
-
-### Phase 4 — Recommendation
-
-<HARD-GATE>
-Do NOT proceed to implementation or architecture planning until the user has reviewed the trade-off matrix and confirmed the recommended option.
-Present the recommendation and wait for explicit approval or selection.
-</HARD-GATE>
-
-1. State the recommended option clearly
-2. Provide confidence level (1-10) with reasoning
-3. Identify the "decision reversal cost" — how hard is it to switch later
-4. List 1-2 things to validate before committing
-
-## Tools Required
-
-- `codebase` — Scan existing stack for constraints
-- `fetch` — Pull external docs/benchmarks when comparing technologies
-- `catalyst_knowledge_search` — Check if similar decisions were made before
-
-## Output Format
-
-```
-## [Catalyst → Solution Design]
-
-### Problem
-{one-sentence problem statement}
-
-### Options
-1. **{Name}** — {approach}
-   - Strengths: ...
-   - Risks: ...
-   - Effort: {T-shirt}
-
-### Trade-off Matrix
-{table}
-
-### Recommendation
-**{Option Name}** (Confidence: {N}/10)
-{reasoning}
-
-**Reversal cost**: {Low/Medium/High}
-**Validate first**: {list}
-```
-
-## Chains To
-
-- `architecture-planner` — When the recommended option needs detailed design
-- `feature-builder` — When the user wants to start implementing immediately
-
-## Anti-Patterns
-
-- Do NOT generate options just to fill a quota — 2 genuine options beat 4 padded ones
-- Do NOT recommend without stating confidence and reversal cost
-- Do NOT skip the trade-off matrix — it's the core value of this skill
+# Solution Design
+
+> **Pillar**: Strategize | **ID**: `strategize-solution-design`
+
+## Purpose
+
+Structured ideation and trade-off analysis for technical decisions. Transforms vague questions into evaluated options with clear recommendations.
+
+## Activation Triggers
+
+- "brainstorm", "explore options", "what are the approaches", "tradeoffs", "should I use X or Y"
+- Any open-ended technical question with multiple viable paths
+
+## Methodology
+
+### Process Flow
+
+```dot
+digraph solution_design {
+    rankdir=TB;
+    node [shape=box];
+
+    frame [label="Phase 1\nProblem Framing"];
+    options [label="Phase 2\nOption Generation\n(3-4 approaches)"];
+    matrix [label="Phase 3\nTrade-off Matrix"];
+    recommend [label="Phase 4\nRecommendation", shape=diamond, style=filled, fillcolor="#ffcccc"];
+    arch [label="architecture-planner", shape=doublecircle];
+    build [label="feature-builder", shape=doublecircle];
+
+    frame -> options;
+    options -> matrix;
+    matrix -> recommend;
+    recommend -> arch [label="needs detailed design"];
+    recommend -> build [label="ready to implement"];
+    recommend -> options [label="user rejects\nall options"];
+}
+```
+
+### Phase 1 — Problem Framing
+1. Restate the problem in one sentence
+2. Identify constraints: time, team size, existing tech stack, scale requirements
+3. Ask 1-2 clarifying questions ONLY if the problem is genuinely ambiguous
+
+### Phase 2 — Option Generation
+1. Generate 3-4 distinct approaches (configurable via `max_options` in config)
+2. Each option must include:
+   - **Name**: Short memorable label
+   - **Approach**: 2-3 sentence description
+   - **Strengths**: What it does well
+   - **Risks**: What could go wrong
+   - **Effort**: T-shirt size (S/M/L/XL) with justification
+3. Options must be genuinely different — not variations of the same approach
+
+### Phase 3 — Trade-off Matrix
+Build a comparison table:
+
+| Criterion | Option A | Option B | Option C |
+|---|---|---|---|
+| Implementation effort | | | |
+| Maintainability | | | |
+| Performance | | | |
+| Team familiarity | | | |
+
+Rate each cell: `++` (strong), `+` (good), `~` (neutral), `-` (weak), `--` (poor)
+
+### Phase 4 — Recommendation
+
+<HARD-GATE>
+Do NOT proceed to implementation or architecture planning until the user has reviewed the trade-off matrix and confirmed the recommended option.
+Present the recommendation and wait for explicit approval or selection.
+</HARD-GATE>
+
+1. State the recommended option clearly
+2. Provide confidence level (1-10) with reasoning
+3. Identify the "decision reversal cost" — how hard is it to switch later
+4. List 1-2 things to validate before committing
+
+## Tools Required
+
+- `codebase` — Scan existing stack for constraints
+- `fetch` — Pull external docs/benchmarks when comparing technologies
+- `crewpilot_knowledge_search` — Check if similar decisions were made before
+
+## Output Format
+
+```
+## [CrewPilot → Solution Design]
+
+### Problem
+{one-sentence problem statement}
+
+### Options
+1. **{Name}** — {approach}
+   - Strengths: ...
+   - Risks: ...
+   - Effort: {T-shirt}
+
+### Trade-off Matrix
+{table}
+
+### Recommendation
+**{Option Name}** (Confidence: {N}/10)
+{reasoning}
+
+**Reversal cost**: {Low/Medium/High}
+**Validate first**: {list}
+```
+
+## Chains To
+
+- `architecture-planner` — When the recommended option needs detailed design
+- `feature-builder` — When the user wants to start implementing immediately
+
+## Anti-Patterns
+
+- Do NOT generate options just to fill a quota — 2 genuine options beat 4 padded ones
+- Do NOT recommend without stating confidence and reversal cost
+- Do NOT skip the trade-off matrix — it's the core value of this skill

package/scripts/postinstall.js

@@ -1,108 +1,108 @@
-/**
- * postinstall.js — Runs after `npm install @crewpilot/agent`
- * 
- * Creates .github/ files in the user's project so @Catalyst agent
- * appears in Copilot Chat dropdown automatically.
- * 
- * Uses INIT_CWD (set by npm to the directory where `npm install` was run).
- * Silently exits on global installs or npx (no project root).
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// INIT_CWD is the directory where the user ran `npm install`
-const projectRoot = process.env.INIT_CWD;
-
-// Skip if no project root (global install, npx, CI, etc.)
-if (!projectRoot) {
-  process.exit(0);
-}
-
-// Skip if installing as a dependency of this package itself (dev scenario)
-const ownPackageDir = path.join(__dirname, '..');
-if (path.resolve(projectRoot) === path.resolve(ownPackageDir)) {
-  process.exit(0);
-}
-
-// Skip if no package.json in project root (not a real project)
-if (!fs.existsSync(path.join(projectRoot, 'package.json'))) {
-  process.exit(0);
-}
-
-const githubDir = path.join(projectRoot, '.github');
-const promptsDir = path.join(__dirname, '..', 'prompts');
-
-// If prompts aren't bundled, silently exit
-if (!fs.existsSync(promptsDir)) {
-  process.exit(0);
-}
-
-let created = 0;
-let skipped = 0;
-
-/**
- * Copy a file from prompts/ to .github/ — never overwrites existing files
- */
-function syncFile(srcName, destRelative) {
-  const src = path.join(promptsDir, srcName);
-  const dest = path.join(githubDir, destRelative);
-
-  if (!fs.existsSync(src)) return;
-
-  if (fs.existsSync(dest)) {
-    skipped++;
-    return;
-  }
-
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-  created++;
-}
-
-/**
- * Copy all skills from prompts/skills/ to .github/skills/
- */
-function syncSkills() {
-  const skillsDir = path.join(promptsDir, 'skills');
-  if (!fs.existsSync(skillsDir)) return;
-
-  const skillDirs = fs.readdirSync(skillsDir).filter(d =>
-    fs.statSync(path.join(skillsDir, d)).isDirectory()
-  );
-
-  for (const name of skillDirs) {
-    const src = path.join(skillsDir, name, 'SKILL.md');
-    if (!fs.existsSync(src)) continue;
-
-    const dest = path.join(githubDir, 'skills', name, 'SKILL.md');
-    if (fs.existsSync(dest)) {
-      skipped++;
-      continue;
-    }
-
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(src, dest);
-    created++;
-  }
-}
-
-// --- Run ---
-try {
-  fs.mkdirSync(githubDir, { recursive: true });
-
-  syncFile('agent.md', path.join('agents', 'catalyst.md'));
-  syncFile('copilot-instructions.md', 'copilot-instructions.md');
-  syncFile('catalyst.config.json', 'catalyst.config.json');
-  syncSkills();
-
-  if (created > 0) {
-    console.log(`\n  ⚡ CrewPilot: Created ${created} file(s) in .github/ (${skipped} already existed)`);
-    console.log('  ⚡ Open Copilot Chat and select @Catalyst from the agent dropdown\n');
-  }
-} catch {
-  // Silently fail — postinstall should never break npm install
-}
+/**
+ * postinstall.js — Runs after `npm install @crewpilot/agent`
+ * 
+ * Creates .github/ files in the user's project so @CrewPilot agent
+ * appears in Copilot Chat dropdown automatically.
+ * 
+ * Uses INIT_CWD (set by npm to the directory where `npm install` was run).
+ * Silently exits on global installs or npx (no project root).
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// INIT_CWD is the directory where the user ran `npm install`
+const projectRoot = process.env.INIT_CWD;
+
+// Skip if no project root (global install, npx, CI, etc.)
+if (!projectRoot) {
+  process.exit(0);
+}
+
+// Skip if installing as a dependency of this package itself (dev scenario)
+const ownPackageDir = path.join(__dirname, '..');
+if (path.resolve(projectRoot) === path.resolve(ownPackageDir)) {
+  process.exit(0);
+}
+
+// Skip if no package.json in project root (not a real project)
+if (!fs.existsSync(path.join(projectRoot, 'package.json'))) {
+  process.exit(0);
+}
+
+const githubDir = path.join(projectRoot, '.github');
+const promptsDir = path.join(__dirname, '..', 'prompts');
+
+// If prompts aren't bundled, silently exit
+if (!fs.existsSync(promptsDir)) {
+  process.exit(0);
+}
+
+let created = 0;
+let skipped = 0;
+
+/**
+ * Copy a file from prompts/ to .github/ — never overwrites existing files
+ */
+function syncFile(srcName, destRelative) {
+  const src = path.join(promptsDir, srcName);
+  const dest = path.join(githubDir, destRelative);
+
+  if (!fs.existsSync(src)) return;
+
+  if (fs.existsSync(dest)) {
+    skipped++;
+    return;
+  }
+
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+  created++;
+}
+
+/**
+ * Copy all skills from prompts/skills/ to .github/skills/
+ */
+function syncSkills() {
+  const skillsDir = path.join(promptsDir, 'skills');
+  if (!fs.existsSync(skillsDir)) return;
+
+  const skillDirs = fs.readdirSync(skillsDir).filter(d =>
+    fs.statSync(path.join(skillsDir, d)).isDirectory()
+  );
+
+  for (const name of skillDirs) {
+    const src = path.join(skillsDir, name, 'SKILL.md');
+    if (!fs.existsSync(src)) continue;
+
+    const dest = path.join(githubDir, 'skills', name, 'SKILL.md');
+    if (fs.existsSync(dest)) {
+      skipped++;
+      continue;
+    }
+
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+    created++;
+  }
+}
+
+// --- Run ---
+try {
+  fs.mkdirSync(githubDir, { recursive: true });
+
+  syncFile('agent.md', path.join('agents', 'crewpilot.md'));
+  syncFile('copilot-instructions.md', 'copilot-instructions.md');
+  syncFile('crewpilot.config.json', 'crewpilot.config.json');
+  syncSkills();
+
+  if (created > 0) {
+    console.log(`\n  ⚡ CrewPilot: Created ${created} file(s) in .github/ (${skipped} already existed)`);
+    console.log('  ⚡ Open Copilot Chat and select @CrewPilot from the agent dropdown\n');
+  }
+} catch {
+  // Silently fail — postinstall should never break npm install
+}