@grvmithas/create-aies-kit 1.0.0 → 1.1.0

package/lib/scaffold.js

@@ -1,352 +0,0 @@
-import { SITE_URL, STACK_LABELS } from './options.js';
-
-function stackDocsUrl(stack) {
-  const map = {
-    react: `${SITE_URL}/docs/cookbook/react/README`,
-    nextjs: `${SITE_URL}/docs/cookbook/nextjs/README`,
-    'react-native': `${SITE_URL}/docs/cookbook/react-native/README`,
-    nodejs: `${SITE_URL}/docs/cookbook/node/README`,
-    python: `${SITE_URL}/docs/cookbook/python/README`,
-    java: `${SITE_URL}/docs/cookbook/java/README`,
-    dotnet: `${SITE_URL}/docs/cookbook/dotnet/README`,
-  };
-  return map[stack] ?? `${SITE_URL}/docs/cookbook/README`;
-}
-
-function idePlacementGuide(ide) {
-  switch (ide) {
-    case 'cursor':
-      return `### Cursor
-- Project rules: \`.cursor/rules/aies.mdc\`
-- Attach \`.aies/implementation_plan.md\` before coding`;
-    case 'claude-code':
-      return `### Claude Code
-- \`CLAUDE.md\` at repo root
-- Skills under \`.aies/skills/\``;
-    case 'copilot':
-      return `### GitHub Copilot
-- \`.github/copilot-instructions.md\`
-- Human PR review remains accountable`;
-    case 'vscode':
-      return `### VS Code
-- \`.vscode/aies-instructions.md\``;
-    case 'windsurf':
-      return `### Windsurf
-- \`.windsurfrules\``;
-    case 'continue':
-      return `### Continue
-- See \`.aies/ide/continue-config.snippet.json\``;
-    default:
-      return '### IDE\n- Use `.aies/` as the project AI harness folder.';
-  }
-}
-
-function buildContextFile(profile, label) {
-  return `# AIES project context
-
-This repository uses the Open AI Engineering Standard (AIES) harness.
-
-- Stack: ${label}
-- Role profile: ${profile.role}
-- Maturity: ${profile.maturity}
-- IDE: ${profile.ide}
-
-## Non-negotiables
-
-1. Plan before multi-file coding (\`.aies/implementation_plan.md\`)
-2. Human review is accountable — AI output is advisory
-3. No secrets in prompts, logs, or MCP tool args
-4. Prefer stack skill + AIDLC prompts over ad-hoc chat
-
-## Start here
-
-1. Read \`.aies/README.md\`
-2. Fill \`.aies/implementation_plan.md\`
-3. Open the matching workflow: ${SITE_URL}/workflows
-4. Stack cookbook: ${stackDocsUrl(profile.stack)}
-
-## Corpus (online)
-
-- Handbook: ${SITE_URL}/docs/handbook/README
-- Hooks: ${SITE_URL}/docs/04-agent-engineering/hooks/README
-- MCP: ${SITE_URL}/docs/handbook/mcp-when-and-how
-`;
-}
-
-/**
- * @param {{ goal: string, role: string, maturity: string, ide: string, stack: string }} profile
- * @returns {{ stack: string, generatedAt: string, profile: object, files: Record<string, string> }}
- */
-export function generateStarterKit(profile) {
-  const label = STACK_LABELS[profile.stack] ?? profile.stack;
-  const now = new Date().toISOString();
-  const flagArgs = [
-    `--stack ${profile.stack}`,
-    `--ide ${profile.ide}`,
-    `--role ${profile.role}`,
-    `--maturity ${profile.maturity}`,
-    `--goal ${profile.goal}`,
-  ].join(' ');
-
-  const readme = `# AIES Starter Kit — ${label}
-
-**This folder is your project harness.** It is not the full AIES corpus.
-
-Generated: ${now}  
-Profile: **${profile.role}** · **${profile.ide}** · **${profile.maturity}** · **${label}**
-
-## What got installed
-
-| Path | Purpose |
-|------|---------|
-| \`.aies/implementation_plan.md\` | Plan of record before coding |
-| \`.aies/prompts/\` | Pasteable AIDLC prompts |
-| \`.aies/skills/\` | Procedural skills for agents |
-| \`.aies/mcp.json\` | Example MCP config (edit before enabling) |
-| \`.aies/agentHooks.json\` | Hook map — wire to real scripts from the corpus |
-| IDE context file | Rules/instructions for ${profile.ide} |
-
-## How to use (5 minutes)
-
-1. Confirm you are in your **app repo root**
-2. Fill \`.aies/implementation_plan.md\`
-3. Attach that plan in IDE chat before generating code
-4. Do not enable MCPs until you read: ${SITE_URL}/docs/handbook/mcp-when-and-how
-5. Continue your lifecycle: ${SITE_URL}/workflows
-
-${idePlacementGuide(profile.ide)}
-
-## Re-install / upgrade
-
-\`\`\`bash
-npx @grvmithas/create-aies-kit ${flagArgs} --force
-\`\`\`
-
-## Not enough alone
-
-For production teams you still need HITL gates, eval/CI gates, and an MCP allowlist.
-
-Quick start: ${SITE_URL}/quickstart
-Cookbook: ${stackDocsUrl(profile.stack)}
-`;
-
-  const implementationPlan = `# Implementation Plan
-
-> AIES plan of record. Approve this before multi-file coding.
-
-## Goal
-
-<!-- One sentence outcome -->
-
-## Scope
-
-### In scope
-
--
-
-### Out of scope
-
--
-
-## Architecture touchpoints
-
--
-
-## Tasks
-
-| ID | Task | Verification | Owner |
-|----|------|--------------|-------|
-| 1 | | | |
-
-## Risks
-
--
-
-## Rollback
-
--
-
-## Human approval
-
-- [ ] Plan approved by:
-- [ ] Date:
-`;
-
-  const storyKickoffSkill = `---
-name: story-kickoff
-description: Frame a bounded story before implementation
----
-
-# Story kickoff
-
-## Inputs
-- Ticket / user story
-- Acceptance criteria
-- Non-goals
-
-## Procedure
-1. Restate the problem in one paragraph
-2. List constraints (security, perf, compliance)
-3. Propose the smallest verifiable slice
-4. Stop for human approval before writing the plan file
-
-## Online prompt
-${SITE_URL}/docs/08-ai-sdlc/prompts/story-kickoff.prompt
-`;
-
-  const implementationPrompt = `# Implementation prompt
-
-Use with the approved \`.aies/implementation_plan.md\` attached.
-
-1. Restate the plan boundaries
-2. Implement only in-scope tasks
-3. Add/adjust tests for verification column
-4. Do not invent integrations outside the plan
-5. Summarize files changed and residual risks
-
-Online: ${SITE_URL}/docs/08-ai-sdlc/prompts/implementation-plan.prompt
-Stack cookbook: ${stackDocsUrl(profile.stack)}
-`;
-
-  const codeReviewPrompt = `# Code review prompt
-
-Human reviewer is accountable. AI output is advisory only.
-
-Review for:
-- Correctness vs plan
-- Security / secrets / injection
-- Missing tests
-- Maintainability
-
-Online: ${SITE_URL}/docs/08-ai-sdlc/prompts/security-review.prompt
-`;
-
-  const debugSkill = `---
-name: debug
-description: Systematic debug for ${label}
----
-
-1. Reproduce with a minimal failing case
-2. Form a hypothesis
-3. Change one variable at a time
-4. Capture evidence before asking for a large rewrite
-
-Online: ${SITE_URL}/docs/03-skill-engineering/skills/debug.skill
-`;
-
-  const devopsSkill = `---
-name: devops
-description: Release and pipeline discipline
----
-
-1. Prefer automated gates over manual checklists alone
-2. Canary / feature flags for risky paths
-3. Rollback verified before production promote
-
-Online: ${SITE_URL}/docs/03-skill-engineering/skills/devops.skill
-`;
-
-  const mcpJson = JSON.stringify(
-    {
-      mcpServers: {},
-      _aies: {
-        note: 'Empty by default. Add only org-approved servers after reading MCP when-and-how.',
-        guide: `${SITE_URL}/docs/handbook/mcp-when-and-how`,
-        catalog: `${SITE_URL}/docs/mcps/README`,
-      },
-    },
-    null,
-    2,
-  );
-
-  const agentHooksJson = JSON.stringify(
-    {
-      version: '1',
-      hooks: [
-        {
-          id: 'pre-planning',
-          phase: 'before-plan',
-          requiredEvidence: ['requirements-path', 'risk-tier'],
-        },
-        {
-          id: 'pre-code',
-          phase: 'before-code',
-          requiredEvidence: ['approved-plan-path'],
-        },
-      ],
-      _aies: {
-        note: 'Wire these phases to shell hooks from the AIES corpus when you adopt the full harness.',
-        hooksGuide: `${SITE_URL}/docs/04-agent-engineering/hooks/README`,
-      },
-    },
-    null,
-    2,
-  );
-
-  const commands = `# Useful next commands
-
-npx @grvmithas/create-aies-kit ${flagArgs} --force
-
-# Then open:
-# ${SITE_URL}/quickstart
-# ${SITE_URL}/workflows
-`;
-
-  const context = buildContextFile(profile, label);
-  /** @type {Record<string, string>} */
-  const files = {
-    '.aies/README.md': readme,
-    '.aies/implementation_plan.md': implementationPlan,
-    '.aies/skills/story-kickoff.skill.md': storyKickoffSkill,
-    '.aies/prompts/implementation.prompt.md': implementationPrompt,
-    '.aies/prompts/code-review.prompt.md': codeReviewPrompt,
-    '.aies/skills/debug.skill.md': debugSkill,
-    '.aies/skills/devops.skill.md': devopsSkill,
-    '.aies/mcp.json': mcpJson,
-    '.aies/agentHooks.json': agentHooksJson,
-    '.aies/commands.md': commands,
-  };
-
-  switch (profile.ide) {
-    case 'cursor':
-      files['.cursor/rules/aies.mdc'] = `---
-description: AIES project harness rules
-globs:
-alwaysApply: true
----
-
-${context}
-`;
-      break;
-    case 'claude-code':
-      files['CLAUDE.md'] = context;
-      break;
-    case 'copilot':
-      files['.github/copilot-instructions.md'] = context;
-      break;
-    case 'vscode':
-      files['.vscode/aies-instructions.md'] = context;
-      break;
-    case 'windsurf':
-      files['.windsurfrules'] = context;
-      break;
-    case 'continue':
-      files['.aies/ide/continue-context.md'] = context;
-      files['.aies/ide/continue-config.snippet.json'] = JSON.stringify(
-        {
-          comment: 'Merge into your Continue config — do not overwrite blindly',
-          contextProviders: [{ name: 'file', params: { path: '.aies' } }],
-        },
-        null,
-        2,
-      );
-      break;
-  }
-
-  return {
-    stack: profile.stack,
-    generatedAt: now,
-    profile: { ...profile },
-    files,
-  };
-}