@houseofwolvesllc/claude-scrum-skill 2.1.2 → 2.1.3

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-scrum-skill",
   "description": "Complete scrum pipeline — PRD to production release with Claude as scrum master. Includes project scaffolding, sprint planning, status tracking, sprint releases, and full-project emulation testing.",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "author": {
     "name": "House of Wolves LLC"
   },

package/bin/install.js

@@ -6,6 +6,7 @@ const path = require('path');
 const HOME = process.env.HOME || process.env.USERPROFILE;
 const SOURCE_DIR = path.join(__dirname, '..', 'skills');
 const WORKFLOWS_SOURCE_DIR = path.join(__dirname, '..', 'lib', 'workflows');
+const GUIDANCE_SOURCE_DIR = path.join(__dirname, '..', 'lib', 'guidance');
 const IS_GLOBAL = process.env.npm_config_global === 'true';
 const CONFIG_FILENAME = 'config.json';
 
@@ -30,6 +31,7 @@ function main() {
   installSharedReferences(skillsDir);
   const installed = installSkills(skillsDir);
   installWorkflows(skillsDir);
+  installGuidance(skillsDir);
 
   if (!IS_GLOBAL) {
     ensureGitignoreEntry(skillsDir);
@@ -121,6 +123,16 @@ function installWorkflows(skillsDir) {
   console.log('  ⚙️  _workflows (lib/workflows + schemas)');
 }
 
+// Copy lib/guidance/ → <skillsDir>/_guidance/ (v2.1.3+).
+// Underscore prefix keeps these internal — orchestrator-injected situational
+// guidance for core epics, never registered as user-facing skills.
+function installGuidance(skillsDir) {
+  if (!fs.existsSync(GUIDANCE_SOURCE_DIR)) return;
+  const guidanceDest = path.join(skillsDir, '_guidance');
+  copyRecursive(GUIDANCE_SOURCE_DIR, guidanceDest);
+  console.log('  🧭 _guidance (design-patterns + domain-modeling)');
+}
+
 function ensureGitignoreEntry(skillsDir) {
   const projectRoot = path.resolve(skillsDir, '..', '..');
   const gitignorePath = path.join(projectRoot, '.gitignore');
@@ -212,4 +224,4 @@ if (require.main === module) {
   main();
 }
 
-module.exports = { deepMerge, installConfig };
+module.exports = { deepMerge, installConfig, installSkills, installGuidance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houseofwolvesllc/claude-scrum-skill",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Claude Code skills for scrum project management — PRD to production release pipeline with project scaffolding, sprint planning, status tracking, sprint releases, full-project emulation testing, autonomous orchestration, and project cleanup.",
   "bin": {},
   "publishConfig": {

package/skills/project-orchestrate/SKILL.md

@@ -17,7 +17,7 @@ Fully autonomous project lifecycle driver. Plans sprints, executes stories via p
 2. Read `../shared/config.json` to determine the scaffolding mode (`scaffolding` key: `"local"`, `"github"`, `"jira"`, or `"trello"`, default: `"local"`). If `"local"`, also read the `paths.backlog` and `paths.context` values (`paths.context` defaults to `.claude-scrum-skill/context` and is where Step 3 subagents look for per-epic CONTEXT.md files). Read `../shared/references/PROVIDERS.md` for provider-specific API commands when using a remote provider.
 3. Read the project's `CLAUDE.md` (if it exists) for project-specific rules. **All subagents you spawn must also read and follow `CLAUDE.md`** — include this instruction explicitly in every subagent prompt.
 3a. Read `../shared/references/ENGINEERING_BASELINE.md` — the universal engineering baseline (Clean Code, Test-Driven Development, and the simple-design Arbitration Rule). It applies to **all** work this orchestration drives, across every epic and story. Resolve its absolute path; you will pass it to the sprint pipeline as `baselinePath` so every implementation and review subagent follows it. Order of precedence: project `CLAUDE.md` > engineering baseline > situational guidance (`design-patterns`, `domain-modeling`).
-3b. **Subdomain classification gates situational guidance.** `/project-spec` classifies each epic as `core`, `supporting`, or `generic`, and `/project-scaffold` persists that classification into epic metadata: the `subdomain` field of each `_epic.md` frontmatter (local mode) or a `subdomain:<value>` label on the epic's issues (remote modes). Read the classification from that epic metadata — the single authoritative source — and do NOT re-derive it. At implementation time, only **`core`** epics receive the situational guidance skills (`design-patterns`, `domain-modeling`); `supporting`, `generic`, and unclassified epics get the baseline only. Resolve the absolute `SKILL.md` paths for the `design-patterns` and `domain-modeling` skills so you can pass them as `situationalGuidance` for core epics.
+3b. **Subdomain classification gates situational guidance.** `/project-spec` classifies each epic as `core`, `supporting`, or `generic`, and `/project-scaffold` persists that classification into epic metadata: the `subdomain` field of each `_epic.md` frontmatter (local mode) or a `subdomain:<value>` label on the epic's issues (remote modes). Read the classification from that epic metadata — the single authoritative source — and do NOT re-derive it. At implementation time, only **`core`** epics receive the situational guidance skills (`design-patterns`, `domain-modeling`); `supporting`, `generic`, and unclassified epics get the baseline only. The two guidance files ship in the non-registered `_guidance/` directory — the same mechanism `_workflows/` uses, where the underscore prefix keeps Claude Code from registering them as user-facing skills. Their absolute paths are `<skills-root>/_guidance/design-patterns/SKILL.md` and `<skills-root>/_guidance/domain-modeling/SKILL.md`, where `<skills-root>` is the parent directory of this SKILL.md's parent (for a SKILL.md at `~/.claude/skills/project-orchestrate/SKILL.md`, `<skills-root>` is `~/.claude/skills`). The same algorithm works for global, local, and plugin install layouts. Pass these two paths as `situationalGuidance` for core epics — there is exactly one place to look, no `node_modules` hunting.
 4. Read `../shared/references/PERSONAS.md` for role preambles. When spawning
    subagents, select the persona matching each story's `persona:*` label (GitHub mode)
    or `persona` frontmatter field (local mode). If no persona exists, use `impl` (the default).
@@ -412,7 +412,7 @@ backendMode:        local | github | jira | trello
 repoIdentifier:     <owner/repo> (github mode only)
 personaPreambles:   { impl: "...", ops: "...", research: "..." }
 baselinePath:       <absolute path to shared/references/ENGINEERING_BASELINE.md> (always set; applies to every story)
-situationalGuidance: <array of absolute SKILL.md paths for design-patterns and domain-modeling — set ONLY when the current epic's subdomain is `core`; omit or pass [] for supporting/generic/untagged epics>
+situationalGuidance: <the two guidance SKILL.md paths from the non-registered _guidance/ directory — `<skills-root>/_guidance/design-patterns/SKILL.md` and `<skills-root>/_guidance/domain-modeling/SKILL.md` (resolve `<skills-root>` per Step 3b) — set ONLY when the current epic's subdomain is `core`; omit or pass [] for supporting/generic/untagged epics>
 ```
 
 Wait for the workflow to return. The return is `SprintStoryReturn[]` — one entry per completed (or blocked / failed) story per `lib/workflows/schemas/SprintStoryReturnSchema.json`.