agile-context-engineering 0.5.0 → 0.5.1

package/skills/plan-backlog/SKILL.md

@@ -1,75 +1,93 @@
----
-name: plan-backlog
-description: Create or refine the product backlog through vision-aware questioning, wiki analysis, and guided epic/feature planning
-argument-hint: "[optional: context='text, file, or URL with product description and suggested epics/features']"
-disable-model-invocation: true
-allowed-tools: Read, Bash, Write, Task, AskUserQuestion
-model: opus
-effort: high
----
-
-# Plan Backlog
-
-Create or refine the product backlog through vision-aware questioning, wiki analysis, and guided epic/feature planning.
-
-## When to Use
-
-- After `/ace:plan-product-vision` — once the vision exists, plan what to build
-- After `/ace:map-system` — once architecture is mapped, leverage wiki context for richer backlog
-- Anytime — to create or refresh the product backlog
-- Product vision exists and you want to break it into epics and features
-- Starting implementation planning and need a structured backlog
-- Brownfield project where features need to be inventoried from existing code
-- Updating the backlog after scope changes or new discoveries
-
-## Input
-
-### Optional
-
-- **`context`** — Product description, suggested epics/features, PRD excerpts, or any context to seed the backlog planning process. Will be absorbed and refined through questioning, not used as-is.
-
-## Environment Context (preprocessed)
-
-!`node "${CLAUDE_SKILL_DIR}/script.js" init "$ARGUMENTS" 2>/dev/null`
-
-## Supporting Resources
-
-Read ALL of these before starting the workflow:
-
-- **Workflow**: Read [workflow.xml](workflow.xml) — complete orchestration process with all steps
-- **Product backlog template**: Read [product-backlog-template.xml](product-backlog-template.xml) — output format for the product backlog
-- **Questioning guide**: Read `${CLAUDE_SKILL_DIR}/../../shared/utils/questioning.xml` — deep questioning techniques
-- **UI formatting**: Read `${CLAUDE_SKILL_DIR}/../../shared/utils/ui-formatting.md` — ACE output formatting rules
-
-## Process
-
-Use the `ace-product-owner` agent for requirements gathering, deep questioning, and backlog specification.
-
-The Environment Context above contains the preprocessed INIT JSON — use it directly instead of running the init script manually. The workflow's step 1 setup can skip the init bash call since that data is already available.
-
-Read all supporting resources listed above, then execute the workflow defined in [workflow.xml](workflow.xml) end-to-end. Preserve all workflow gates (validation, approvals, commits).
-
-## Artifacts
-
-```
-.ace/artifacts/product/product-backlog.md
-```
-
-## Example Usage
-
-```
-# Create a new product backlog
-/ace:plan-backlog
-
-# Create backlog with seed context
-/ace:plan-backlog context="E-commerce platform with user accounts, product catalog, and checkout"
-
-# Refine existing backlog after scope changes
-/ace:plan-backlog
-```
-
-## Next Steps
-
-- `/ace:plan-feature E1` — Break a feature into detailed stories
-- `/ace:help` — Check project initialization status
-- `/ace:plan-product-vision` — Update the product vision if priorities shifted
+---
+name: plan-backlog
+description: Create or refine the product backlog through vision-aware questioning, wiki analysis, and guided epic/feature planning
+argument-hint: "[optional: context='text, file, or URL with product description and suggested epics/features']"
+disable-model-invocation: true
+allowed-tools: Read, Bash, Write, Task, AskUserQuestion
+model: opus
+effort: high
+---
+
+## Environment Context (preprocessed)
+
+!`node "${CLAUDE_SKILL_DIR}/script.js" init 2>/dev/null`
+
+## Supporting Resources (auto-loaded)
+
+!`cat "${CLAUDE_SKILL_DIR}/workflow.xml"`
+
+!`cat "${CLAUDE_SKILL_DIR}/product-backlog-template.xml"`
+
+!`cat "${CLAUDE_SKILL_DIR}/../../shared/utils/questioning.xml"`
+
+!`cat "${CLAUDE_SKILL_DIR}/../../shared/utils/ui-formatting.md"`
+
+```xml
+<command>
+
+    <execution-time>
+        <runs-after>
+            <trigger>After /ace:plan-product-vision — once the vision exists, plan what to build</trigger>
+            <trigger>After /ace:map-system — once architecture is mapped, leverage wiki context for richer backlog</trigger>
+            <trigger>Anytime — to create or refresh the product backlog</trigger>
+        </runs-after>
+        <use-when>
+            <condition>Product vision exists and you want to break it into epics and features</condition>
+            <condition>Starting implementation planning and need a structured backlog</condition>
+            <condition>Brownfield project where features need to be inventoried from existing code</condition>
+            <condition>Updating the backlog after scope changes or new discoveries</condition>
+        </use-when>
+    </execution-time>
+
+    <input>
+        <flags>
+        </flags>
+
+        <parameters>
+            <required>
+            </required>
+
+            <optional>
+                <param name="context" type="file | text">
+                    Product description, suggested epics/features, PRD excerpts, or any
+                    context to seed the backlog planning process. Will be absorbed and
+                    refined through questioning, not used as-is.
+                </param>
+            </optional>
+        </parameters>
+    </input>
+
+    <execution-context>
+        <!-- All supporting files are auto-loaded in the Supporting Resources section above.
+             The model does NOT need to Read these files — they are already in context. -->
+    </execution-context>
+
+    <output>
+        <objective>
+            Detect the project environment, load the product vision as the north-star input,
+            optionally analyze the wiki for existing capabilities and feature status,
+            optionally research the domain ecosystem for standard features,
+            absorb any user-provided context, conduct deep questioning to discover all
+            epics and features, and generate a comprehensive product-backlog.md.
+        </objective>
+
+        <artifacts>
+            .ace/artifacts/product/product-backlog.md
+        </artifacts>
+    </output>
+
+    <process>
+        Execute the plan-backlog workflow from
+        `workflow.xml` end-to-end.
+        Preserve all workflow gates (validation, approvals, commits).
+    </process>
+
+    <next-steps>
+        **After this command:**
+        - `/ace:plan-feature E1` — Break an feature into detailed stories
+        - `/ace:help` — Check project initialization status
+        - `/ace:plan-product-vision` — Update the product vision if priorities shifted
+    </next-steps>
+
+</command>
+```

package/skills/plan-backlog/script.js

@@ -1,136 +1,121 @@
-#!/usr/bin/env node
-
-/**
- * plan-backlog skill script — Entry point for ace-tools operations
- * needed by the plan-backlog skill.
- *
- * Subcommands:
- *   init [args]           Environment detection for plan-backlog workflow
- *   resolve-fields [args] Resolve GitHub Project field IDs
- *   create-issue [args]   Create a GitHub issue in a project
- *   fetch-issues [args]   Fetch all epics/features from a GitHub project
- *
- * Usage: node script.js <subcommand> [args] [--raw]
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const {
-  loadConfig, pathExists, resolveModel,
-  detectBrownfieldStatus, loadSettings, output, error,
-} = require('../../shared/lib/ace-core');
-
-const {
-  resolveFields, createIssue, fetchIssues,
-} = require('../../shared/lib/ace-github');
-
-// ─── CLI Dispatch ────────────────────────────────────────────────────────────
-
-const cwd = process.cwd();
-const args = process.argv.slice(2);
-const raw = args.includes('--raw');
-const cmd = args[0];
-
-switch (cmd) {
-  case 'init':
-    cmdInit(cwd, raw, args.slice(1).filter(a => a !== '--raw'));
-    break;
-  case 'resolve-fields':
-    resolveFields(cwd, raw, args.slice(1).filter(a => a !== '--raw'));
-    break;
-  case 'create-issue':
-    createIssue(cwd, raw, args.slice(1).filter(a => a !== '--raw'));
-    break;
-  case 'fetch-issues':
-    fetchIssues(cwd, raw, args.slice(1).filter(a => a !== '--raw'));
-    break;
-  default:
-    error(`Unknown command: ${cmd}\nAvailable: init, resolve-fields, create-issue, fetch-issues`);
-}
-
-// ─── Init: Plan Backlog ─────────────────────────────────────────────────────
-
-function cmdInit(cwd, raw) {
-  const config = loadConfig(cwd);
-  const brownfield = detectBrownfieldStatus(cwd);
-
-  // Wiki detection — system-wide
-  const wikiSystemDir = '.docs/wiki/system-wide';
-  const has_wiki_system_wide = pathExists(cwd, wikiSystemDir);
-  const has_system_architecture = pathExists(cwd, path.join(wikiSystemDir, 'system-architecture.md'));
-  const has_system_structure = pathExists(cwd, path.join(wikiSystemDir, 'system-structure.md'));
-  const has_testing_framework = pathExists(cwd, path.join(wikiSystemDir, 'testing-framework.md'));
-
-  // Wiki detection — subsystems
-  const wikiSubsystemsDir = '.docs/wiki/subsystems';
-  const has_wiki_subsystems = pathExists(cwd, wikiSubsystemsDir);
-
-  let wiki_subsystem_names = [];
-  if (has_wiki_subsystems) {
-    try {
-      const entries = fs.readdirSync(path.join(cwd, wikiSubsystemsDir), { withFileTypes: true });
-      wiki_subsystem_names = entries
-        .filter(e => e.isDirectory())
-        .map(e => e.name);
-    } catch {}
-  }
-
-  const has_wiki = has_wiki_system_wide || has_wiki_subsystems;
-
-  const result = {
-    // Models
-    product_owner_model: resolveModel(cwd, 'ace-product-owner'),
-    researcher_model: resolveModel(cwd, 'ace-project-researcher'),
-
-    // Config
-    commit_docs: config.commit_docs,
-
-    // Product artifacts
-    has_product_vision: pathExists(cwd, '.docs/product/product-vision.md'),
-    has_product_backlog: pathExists(cwd, '.ace/artifacts/product/product-backlog.md'),
-
-    // Research artifacts (from previous runs)
-    has_features_research: pathExists(cwd, '.ace/research/FEATURES.md'),
-    has_architecture_research: pathExists(cwd, '.ace/research/ARCHITECTURE.md'),
-
-    // Wiki analysis cache (from previous runs)
-    has_wiki_analysis: pathExists(cwd, '.ace/artifacts/wiki/wiki-analysis.md'),
-
-    // Brownfield detection
-    ...brownfield,
-
-    // Wiki state — system-wide
-    has_wiki,
-    has_wiki_system_wide,
-    has_system_architecture,
-    has_system_structure,
-    has_testing_framework,
-
-    // Wiki state — subsystems
-    has_wiki_subsystems,
-    wiki_subsystem_names,
-
-    // Git state
-    has_git: pathExists(cwd, '.git'),
-
-    // GitHub CLI
-    has_gh_cli: (() => {
-      try {
-        const { execSync } = require('child_process');
-        execSync('gh --version', { stdio: 'pipe' });
-        return true;
-      } catch {
-        return false;
-      }
-    })(),
-
-    // GitHub Project settings (from settings.json)
-    github_project: (() => {
-      const settings = loadSettings(cwd);
-      return settings.github_project;
-    })(),
-  };
-
-  output(result, raw);
-}
+#!/usr/bin/env node
+
+/**
+ * plan-backlog skill script — Entry point for ace-tools operations
+ * needed by the plan-backlog skill.
+ *
+ * Subcommands:
+ *   init [args]           Environment detection for plan-backlog workflow
+ *   resolve-fields [args] Resolve GitHub Project field IDs
+ *   create-issue [args]   Create a GitHub issue in a project
+ *   fetch-issues [args]   Fetch all epics/features from a GitHub project
+ *
+ * Usage: node script.js <subcommand> [args] [--raw]
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const {
+  loadConfig, pathExists, resolveModel,
+  detectBrownfieldStatus, loadSettings, output, error, runSkillScript,
+} = require('../../shared/lib/ace-core');
+
+const {
+  resolveFields, createIssue, fetchIssues,
+} = require('../../shared/lib/ace-github');
+
+// ─── CLI Dispatch ────────────────────────────────────────────────────────────
+
+runSkillScript({
+  init: cmdInit,
+  'resolve-fields': (cwd, raw, args) => resolveFields(cwd, raw, args),
+  'create-issue': (cwd, raw, args) => createIssue(cwd, raw, args),
+  'fetch-issues': (cwd, raw, args) => fetchIssues(cwd, raw, args),
+});
+
+// ─── Init: Plan Backlog ─────────────────────────────────────────────────────
+
+function cmdInit(cwd, raw, args, parsed) {
+  const config = loadConfig(cwd);
+  const brownfield = detectBrownfieldStatus(cwd);
+
+  // Wiki detection — system-wide
+  const wikiSystemDir = '.docs/wiki/system-wide';
+  const has_wiki_system_wide = pathExists(cwd, wikiSystemDir);
+  const has_system_architecture = pathExists(cwd, path.join(wikiSystemDir, 'system-architecture.md'));
+  const has_system_structure = pathExists(cwd, path.join(wikiSystemDir, 'system-structure.md'));
+  const has_testing_framework = pathExists(cwd, path.join(wikiSystemDir, 'testing-framework.md'));
+
+  // Wiki detection — subsystems
+  const wikiSubsystemsDir = '.docs/wiki/subsystems';
+  const has_wiki_subsystems = pathExists(cwd, wikiSubsystemsDir);
+
+  let wiki_subsystem_names = [];
+  if (has_wiki_subsystems) {
+    try {
+      const entries = fs.readdirSync(path.join(cwd, wikiSubsystemsDir), { withFileTypes: true });
+      wiki_subsystem_names = entries
+        .filter(e => e.isDirectory())
+        .map(e => e.name);
+    } catch {}
+  }
+
+  const has_wiki = has_wiki_system_wide || has_wiki_subsystems;
+
+  const result = {
+    // Models
+    product_owner_model: resolveModel(cwd, 'ace-product-owner'),
+    researcher_model: resolveModel(cwd, 'ace-project-researcher'),
+
+    // Config
+    commit_docs: config.commit_docs,
+
+    // Product artifacts
+    has_product_vision: pathExists(cwd, '.docs/product/product-vision.md'),
+    has_product_backlog: pathExists(cwd, '.ace/artifacts/product/product-backlog.md'),
+
+    // Research artifacts (from previous runs)
+    has_features_research: pathExists(cwd, '.ace/research/FEATURES.md'),
+    has_architecture_research: pathExists(cwd, '.ace/research/ARCHITECTURE.md'),
+
+    // Wiki analysis cache (from previous runs)
+    has_wiki_analysis: pathExists(cwd, '.ace/artifacts/wiki/wiki-analysis.md'),
+
+    // Brownfield detection
+    ...brownfield,
+
+    // Wiki state — system-wide
+    has_wiki,
+    has_wiki_system_wide,
+    has_system_architecture,
+    has_system_structure,
+    has_testing_framework,
+
+    // Wiki state — subsystems
+    has_wiki_subsystems,
+    wiki_subsystem_names,
+
+    // Git state
+    has_git: pathExists(cwd, '.git'),
+
+    // GitHub CLI
+    has_gh_cli: (() => {
+      try {
+        const { execSync } = require('child_process');
+        execSync('gh --version', { stdio: 'pipe' });
+        return true;
+      } catch {
+        return false;
+      }
+    })(),
+
+    // GitHub Project settings (from settings.json)
+    github_project: (() => {
+      const settings = loadSettings(cwd);
+      return settings.github_project;
+    })(),
+  };
+
+  output(result, raw);
+}

package/skills/plan-backlog/script.test.js

@@ -1,83 +1,83 @@
-const { describe, it, before, after } = require('node:test');
-const assert = require('node:assert');
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const SCRIPT = path.join(__dirname, 'script.js');
-
-function createTestProject() {
-  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ace-test-'));
-
-  const aceDir = path.join(tmpDir, '.ace');
-  fs.mkdirSync(aceDir, { recursive: true });
-  fs.writeFileSync(path.join(aceDir, 'config.json'), JSON.stringify({
-    version: '0.1.0',
-    projectName: 'test-project',
-    model_profile: 'quality',
-    commit_docs: true,
-    github: { enabled: false },
-  }, null, 2));
-
-  fs.writeFileSync(path.join(aceDir, 'settings.json'), JSON.stringify({
-    model_profile: 'quality',
-    commit_docs: true,
-    agent_teams: false,
-    github_project: { enabled: false, gh_installed: false, repo: '', project_number: null, owner: '' },
-  }, null, 2));
-
-  return tmpDir;
-}
-
-function runScript(subcommand, args, cwd) {
-  return execSync(`node "${SCRIPT}" ${subcommand} ${args}`, {
-    cwd,
-    encoding: 'utf-8',
-    timeout: 10000,
-  });
-}
-
-function cleanup(tmpDir) {
-  fs.rmSync(tmpDir, { recursive: true, force: true });
-}
-
-describe('plan-backlog script', () => {
-  it('errors on unknown command', () => {
-    assert.throws(() => {
-      execSync(`node "${SCRIPT}" bogus`, { encoding: 'utf-8', stdio: 'pipe' });
-    });
-  });
-
-  describe('init', () => {
-    let tmpDir;
-
-    before(() => { tmpDir = createTestProject(); });
-    after(() => { cleanup(tmpDir); });
-
-    it('init returns valid JSON', () => {
-      const result = JSON.parse(runScript('init', '', tmpDir));
-      assert.ok(typeof result === 'object');
-      assert.ok(result.product_owner_model, 'should have product_owner_model');
-      assert.ok(result.researcher_model, 'should have researcher_model');
-      assert.strictEqual(typeof result.commit_docs, 'boolean');
-      assert.strictEqual(typeof result.has_git, 'boolean');
-      assert.strictEqual(typeof result.is_brownfield, 'boolean');
-      assert.strictEqual(typeof result.has_product_vision, 'boolean');
-      assert.strictEqual(typeof result.has_product_backlog, 'boolean');
-      assert.strictEqual(typeof result.has_features_research, 'boolean');
-      assert.strictEqual(typeof result.has_architecture_research, 'boolean');
-      assert.strictEqual(typeof result.has_wiki_analysis, 'boolean');
-      assert.strictEqual(typeof result.has_wiki, 'boolean');
-      assert.strictEqual(typeof result.has_gh_cli, 'boolean');
-      assert.ok(result.github_project !== undefined, 'should have github_project');
-    });
-
-    it('returns brownfield detection fields', () => {
-      const result = JSON.parse(runScript('init', '', tmpDir));
-      assert.strictEqual(typeof result.is_brownfield, 'boolean');
-      assert.strictEqual(typeof result.is_greenfield, 'boolean');
-      assert.strictEqual(result.is_brownfield, !result.is_greenfield);
-    });
-  });
-});
+const { describe, it, before, after } = require('node:test');
+const assert = require('node:assert');
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const SCRIPT = path.join(__dirname, 'script.js');
+
+function createTestProject() {
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ace-test-'));
+
+  const aceDir = path.join(tmpDir, '.ace');
+  fs.mkdirSync(aceDir, { recursive: true });
+  fs.writeFileSync(path.join(aceDir, 'config.json'), JSON.stringify({
+    version: '0.1.0',
+    projectName: 'test-project',
+    model_profile: 'quality',
+    commit_docs: true,
+    github: { enabled: false },
+  }, null, 2));
+
+  fs.writeFileSync(path.join(aceDir, 'settings.json'), JSON.stringify({
+    model_profile: 'quality',
+    commit_docs: true,
+    agent_teams: false,
+    github_project: { enabled: false, gh_installed: false, repo: '', project_number: null, owner: '' },
+  }, null, 2));
+
+  return tmpDir;
+}
+
+function runScript(subcommand, args, cwd) {
+  return execSync(`node "${SCRIPT}" ${subcommand} ${args}`, {
+    cwd,
+    encoding: 'utf-8',
+    timeout: 10000,
+  });
+}
+
+function cleanup(tmpDir) {
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+}
+
+describe('plan-backlog script', () => {
+  it('errors on unknown command', () => {
+    assert.throws(() => {
+      execSync(`node "${SCRIPT}" bogus`, { encoding: 'utf-8', stdio: 'pipe' });
+    });
+  });
+
+  describe('init', () => {
+    let tmpDir;
+
+    before(() => { tmpDir = createTestProject(); });
+    after(() => { cleanup(tmpDir); });
+
+    it('init returns valid JSON', () => {
+      const result = JSON.parse(runScript('init', '', tmpDir));
+      assert.ok(typeof result === 'object');
+      assert.ok(result.product_owner_model, 'should have product_owner_model');
+      assert.ok(result.researcher_model, 'should have researcher_model');
+      assert.strictEqual(typeof result.commit_docs, 'boolean');
+      assert.strictEqual(typeof result.has_git, 'boolean');
+      assert.strictEqual(typeof result.is_brownfield, 'boolean');
+      assert.strictEqual(typeof result.has_product_vision, 'boolean');
+      assert.strictEqual(typeof result.has_product_backlog, 'boolean');
+      assert.strictEqual(typeof result.has_features_research, 'boolean');
+      assert.strictEqual(typeof result.has_architecture_research, 'boolean');
+      assert.strictEqual(typeof result.has_wiki_analysis, 'boolean');
+      assert.strictEqual(typeof result.has_wiki, 'boolean');
+      assert.strictEqual(typeof result.has_gh_cli, 'boolean');
+      assert.ok(result.github_project !== undefined, 'should have github_project');
+    });
+
+    it('returns brownfield detection fields', () => {
+      const result = JSON.parse(runScript('init', '', tmpDir));
+      assert.strictEqual(typeof result.is_brownfield, 'boolean');
+      assert.strictEqual(typeof result.is_greenfield, 'boolean');
+      assert.strictEqual(result.is_brownfield, !result.is_greenfield);
+    });
+  });
+});