@williambeto/ai-workflow 1.19.1 → 2.2.0

package/packages/ai-workflow/src/core/templates.js

@@ -1,276 +0,0 @@
-import { getFullAgentContent, getFullSkillFiles, discoverPackageFiles, readPackageFile, getPackageVersion } from "./package-assets.js";
-
-const COMMON_FILES = {
-  "README.workflow.md": `# AI Workflow Setup\n\nThis project is configured for Codex and OpenCode workflows via \`ai-workflow\`.\n\n## Quick start\n\n1. Run validation command for your project.\n2. Start your AI workflow using repository prompts and agent commands.\n3. Keep changes small and evidence-based.\n`,
-  ".codex/prompts/README.md": `# Codex Prompts\n\nThis directory is managed by \`ai-workflow\` init.\n\n## Generated by profile\n\n- \`minimal\`: this README only.\n- \`full\`: starter prompt entrypoints are generated.\n\n## If starter prompt files are missing\n\nRe-run:\n\n\`\`\`bash\nnpx ai-workflow init --yes --profile=full --force\n\`\`\`\n\n## Expected starter prompt files (full profile)\n\n- \`.codex/prompts/start-project.md\`\n- \`.codex/prompts/orchestrate-next.md\`\n- \`.codex/prompts/plan-from-requirement.md\`\n- \`.codex/prompts/execute-selected-pr.md\`\n- \`.codex/prompts/review-implementation.md\`\n- \`.codex/prompts/validate-work.md\`\n`,
-  "opencode/README.md": `# OpenCode Setup\n\nThis directory is managed by \`ai-workflow\` init.\nAdd agent and command files required by your project workflow.\n`
-};
-
-const OPERATIONAL_FILES = {};
-
-const FULL_CODEX_PROMPT_FILES = {
-  ".codex/prompts/start-project.md": `# Start Project (Codex)
-
-Use this starter prompt to begin a repository workflow.
-
-## Instructions
-
-1. If \`AGENTS.md\` exists, read it and follow repository constraints. If it does not exist, use \`README.workflow.md\` and \`.ai-workflow.json\` as the local workflow contract.
-2. Confirm current objective, scope, and expected output.
-3. Propose the smallest safe next step.
-4. Provide validation evidence for each completed step.
-`,
-  ".codex/prompts/plan-from-requirement.md": `# Plan from Requirement (Codex)
-
-Convert a requirement into a safe technical execution plan.
-
-## Instructions
-
-1. Confirm acceptance criteria and constraints.
-2. Identify in-scope files and out-of-scope files.
-3. Propose incremental PR steps.
-4. Define validation commands and evidence expected per step.
-`,
-  ".codex/prompts/execute-selected-pr.md": `# Execute Selected PR (Codex)
-
-Implement only the selected PR scope.
-
-## Instructions
-
-1. Restate selected scope and no-regression requirement.
-2. Apply minimal file-by-file changes.
-3. Run relevant validations.
-4. Report files changed, risks, and evidence.
-`,
-  ".codex/prompts/review-implementation.md": `# Review Implementation (Codex)
-
-Review implemented scope with severity-based findings.
-
-## Instructions
-
-1. Inspect changed files against acceptance criteria.
-2. Classify findings (High/Medium/Low).
-3. Include evidence and impact for each finding.
-4. Give final recommendation (Approved / Approved with notes / Changes requested / Blocked).
-`,
-  ".codex/prompts/validate-work.md": `# Validate Work (Codex)
-
-Run final validation before progression.
-
-## Instructions
-
-1. Execute required validation commands.
-2. Capture command outputs and failures.
-3. Confirm no-regression and unresolved risks.
-4. Return final status with evidence.
-`,
-  ".codex/prompts/orchestrate-next.md": `# Orchestrate Next (Codex)
-
-Progress a task through manual gates using local workflow files.
-
-## Instructions
-
-1. Determine current step owner: planner, implementer, reviewer, validator, release-manager.
-2. Apply gate checks from \`harness/workflows/multi-agent-handoff.md\`.
-3. If blocked, return the smallest safe fix request.
-4. If pass, return next owner and required handoff packet.
-5. Before merge/deploy actions, require explicit user confirmation.
-
-## Required context fallback
-
-- If \`AGENTS.md\` exists, use it as primary contract.
-- If \`AGENTS.md\` is missing, use \`README.workflow.md\` and \`.ai-workflow.json\`.
-
-## Expected output
-
-- Current step and owner
-- Gate result: Pass or Blocked
-- Blocking reason (if any)
-- Next owner
-- Required inputs for next step
-`
-};
-
-const FULL_PRIMARY_AGENTS = [
-  "atlas",
-  "discovery",
-  "planner",
-  "implementer",
-  "fixer",
-  "reviewer",
-  "validator",
-  "release-manager",
-  "wordpress-engineer",
-  "prompt-engineer",
-  "spec-engineer",
-  "orchestrator"
-];
-
-const FULL_SKILLS = [
-  "backend-implementer",
-  "build-and-validate",
-  "pr-orchestrator",
-  "deploy-engineer",
-  "docs-writer",
-  "frontend-implementer",
-  "interface-design",
-  "minimal-context",
-  "napkin",
-  "opencode-agent-design",
-  "playwright-cli",
-  "product-manager",
-  "seo-audit",
-  "stack-variant-creator",
-  "tech-lead",
-  "tester",
-  "token-economy",
-  "vue-nuxt",
-  "wordpress-engineer"
-];
-
-const KIT_VERSION = getPackageVersion() ?? "unknown";
-
-function buildFullFiles() {
-  const files = {};
-
-  Object.assign(files, FULL_CODEX_PROMPT_FILES);
-
-  // ── OpenCode agents ──────────────────────────────────────────────
-  for (const agent of FULL_PRIMARY_AGENTS) {
-    const content = getFullAgentContent(agent);
-    if (content !== null) {
-      files[`opencode/agents/${agent}.md`] = content;
-    } else {
-      files[`opencode/agents/${agent}.md`] = `# ${agent}\n\nThis file is managed by \`ai-workflow\` full profile.\nUse this role for ${agent} tasks with scoped changes and explicit validation evidence.\n`;
-    }
-  }
-
-  // ── Skills (SKILL.md + any references/) ──────────────────────────
-  for (const skill of FULL_SKILLS) {
-    const skillFiles = getFullSkillFiles(skill);
-    if (Object.keys(skillFiles).length > 0) {
-      Object.assign(files, skillFiles);
-    } else {
-      files[`.agents/skills/${skill}/SKILL.md`] = `# ${skill}\n\nThis skill file is managed by \`ai-workflow\` full profile.\nUse it for ${skill} responsibilities with small safe steps and evidence.\n`;
-    }
-  }
-
-  // ── Napkin memory seed (used by napkin skill) ─────────────────────
-  const napkinContent = readPackageFile(".agents/napkin.md");
-  if (napkinContent !== null) {
-    files[".agents/napkin.md"] = napkinContent;
-  }
-
-  // ── OpenCode commands ────────────────────────────────────────────
-  const commandFiles = discoverPackageFiles("opencode/commands");
-  for (const [relPath, content] of Object.entries(commandFiles)) {
-    if (!files[relPath]) {
-      files[relPath] = content;
-    }
-  }
-
-  // ── Additional .codex/prompts not in FULL_CODEX_PROMPT_FILES ────
-  const additionalCodexPrompts = discoverPackageFiles(".codex/prompts");
-  for (const [relPath, content] of Object.entries(additionalCodexPrompts)) {
-    if (!files[relPath]) {
-      files[relPath] = content;
-    }
-  }
-
-  // ── Workflow contracts referenced by orchestrator/agents ────────
-  const harnessWorkflowFiles = discoverPackageFiles("harness/workflows");
-  Object.assign(files, harnessWorkflowFiles);
-
-  const harnessHandoffFiles = discoverPackageFiles("harness/handoffs");
-  Object.assign(files, harnessHandoffFiles);
-
-  // ── Policy docs ─────────────────────────────────────────────────
-  const policyContent = readPackageFile("docs/architecture-policy.md");
-  if (policyContent !== null) files["docs/architecture-policy.md"] = policyContent;
-
-  const dpContent = readPackageFile("docs/design-patterns-policy.md");
-  if (dpContent !== null) files["docs/design-patterns-policy.md"] = dpContent;
-
-  // ── Templates (as project-usable copies) ────────────────────────
-  const templateFiles = discoverPackageFiles("templates");
-  Object.assign(files, templateFiles);
-
-  // ── Schemas (referenced by .ai-workflow.json) ───────────────────
-  const schemaFiles = discoverPackageFiles("schemas");
-  Object.assign(files, schemaFiles);
-
-  return files;
-}
-
-const FULL_FILES = buildFullFiles();
-
-export const PROFILE_FILES = {
-  minimal: {
-    ...COMMON_FILES
-  },
-  operational: {
-    ...COMMON_FILES,
-    ...OPERATIONAL_FILES
-  },
-  full: {
-    ...COMMON_FILES,
-    ...OPERATIONAL_FILES,
-    ...FULL_FILES
-  }
-};
-
-export function isValidProfile(profile) {
-  return Object.hasOwn(PROFILE_FILES, profile);
-}
-
-export function getTemplateFiles(profile) {
-  return PROFILE_FILES[profile] ?? PROFILE_FILES.operational;
-}
-
-export function getManagedBlocks(profile) {
-  if (profile === "minimal") {
-    return [];
-  }
-
-  if (profile === "full") {
-    return [
-      "opencode.jsonc:agent.default",
-      ...FULL_PRIMARY_AGENTS.map((agent) => `opencode.jsonc:agent.${agent}`),
-      ...FULL_SKILLS.map((skill) => `opencode.jsonc:agent.${skill}`),
-      "opencode.jsonc:command.start",
-      "opencode.jsonc:command.ship",
-      "opencode.jsonc:command.plan",
-      "opencode.jsonc:command.execute",
-      "opencode.jsonc:command.review",
-      "opencode.jsonc:command.validate"
-    ];
-  }
-
-  return [
-    "opencode.jsonc:agent.default",
-    "opencode.jsonc:command.start"
-  ];
-}
-
-export function buildAiWorkflowConfig({ profile, managedFiles, managedLinks = [] }) {
-  const now = new Date().toISOString();
-
-  return {
-    $schema: "./schemas/ai-workflow.schema.json",
-    version: 2,
-    kitVersion: KIT_VERSION,
-    mode: "standalone",
-    profile,
-    installedAt: now,
-    lastInitAt: now,
-    managedFiles,
-    managedLinks,
-    managedBlocks: getManagedBlocks(profile),
-    fileHashes: {},
-    backupsDir: ".ai-workflow-backups",
-    compatibility: {
-      codex: true,
-      opencode: true
-    }
-  };
-}

package/runbooks/agent-delegation-workflow.md

@@ -1,111 +0,0 @@
-# Agent Delegation Workflow
-
-## Purpose
-
-Define how tasks are routed from a primary/orchestrator role to specialist agents with explicit ownership, handoff contracts, and validation evidence.
-
-## When to delegate
-
-Delegate when at least one is true:
-
-- the task is multi-step and crosses planning/implementation/review/validation boundaries;
-- the task needs specialist judgment (architecture, testing, deployment, WordPress, OpenCode design, etc.);
-- risk is `Medium` or `High` and independent review/validation is needed.
-
-Do not delegate for trivial one-file edits that the active primary agent can complete safely.
-
-## Discovery guard (mandatory)
-
-- `discovery` is clarification-only and is not an execution owner.
-- If a request during discovery requires implementation, file edits, validation execution, release actions, or specialist delegation, return `Blocked` and hand off to `orchestrator`.
-- Branch gate ownership remains with `orchestrator` and step owners (`planner`, `implementer`, `fixer`, `reviewer`, `validator`, `release-manager`) before write operations.
-
-## Delegation matrix
-
-| Task type | Primary owner |
-| --- | --- |
-| Product requirements and scope | `product-manager` |
-| Architecture and trade-offs | `tech-lead` |
-| Frontend implementation | `frontend-implementer` |
-| Backend/API/data implementation | `backend-implementer` |
-| Build/tooling/validation failures | `build-and-validate` |
-| Test strategy and regression validation | `tester` |
-| Deployment/release/CI/CD readiness | `deploy-engineer` |
-| Documentation/runbooks/prompts/changelog | `docs-writer` |
-| Token economy and context compaction | `token-economy` |
-| OpenCode agent/command/config changes | `opencode-agent-design` |
-| Vue/Nuxt architecture workflows | `vue-nuxt` or `vue-nuxt` |
-| WordPress/PHP work | `wordpress-engineer` |
-| Durable project memory updates | `napkin` |
-
-## Delegation contract
-
-Every delegation packet must include:
-
-- Task summary
-- Relevant files
-- Constraints
-- Expected output
-- Validation required
-- Risk level (`High`/`Medium`/`Low`)
-- Do-not-change list
-- Evidence required
-
-Every specialist response must include:
-
-- Findings or implementation summary
-- Files changed or files inspected
-- Risks
-- Validation commands
-- Open questions (if any)
-- Recommendation
-
-## Anti-overdelegation rules
-
-- Do not delegate trivial one-file documentation edits.
-- Do not delegate if current primary agent can safely complete the task with existing instructions.
-- Do not delegate to more than 2 agents unless work is explicitly cross-functional.
-- Prefer one owner + one reviewer over broad parallel delegation.
-- Always delegate review/validation for high-risk implementation.
-
-## Escalation rules
-
-- Architecture changes -> consult `tech-lead`
-- User-facing behavior changes -> consult `tester`
-- Command/CI/build changes -> consult `build-and-validate`
-- Docs/runbook/prompt changes -> consult `docs-writer`
-- OpenCode agent/config changes -> consult `opencode-agent-design`
-- Durable project-memory discoveries -> update Napkin via `napkin`
-
-## Examples
-
-### Feature request
-
-`orchestrator -> planner -> implementer -> reviewer -> validator -> release-manager`
-
-### Bug fix
-
-`orchestrator -> fixer -> reviewer -> validator`
-
-### Docs update (small)
-
-No delegation required if one-file low-risk edit is clear and validated.
-
-### Validation failure
-
-`orchestrator -> build-and-validate -> implementer/fixer -> validator`
-
-### Deployment task
-
-`orchestrator -> deploy-engineer -> tester (if behavior risk) -> release-manager`
-
-## Delegation validation checklist
-
-- [ ] Primary/orchestrator owner is explicit.
-- [ ] Task type -> specialist mapping is explicit.
-- [ ] Delegation contract fields are present.
-- [ ] Specialist response contract fields are present.
-- [ ] Review/validation chain is explicit for risky work.
-- [ ] Overdelegation rules were applied.
-- [ ] Escalation paths are explicit.
-- [ ] Evidence requirements are explicit.