@vpxa/aikit 0.1.76 → 0.1.78

package/scaffold/definitions/exclusions.mjs

@@ -1,58 +0,0 @@
-/**
- * Permanent Exclusions — things aikit intentionally will NOT do.
- *
- * Each exclusion includes rationale grounded in the Bitter Lesson:
- * systems should leverage computation over hand-crafted features.
- * These exclusions are injected into copilot-instructions.md.
- */
-
-export const PERMANENT_EXCLUSIONS = [
-  {
-    name: 'Hard-coded lint rules',
-    rationale:
-      'Project-specific linting belongs in ESLint or Biome config, not baked into agent instructions. Configurable tooling and automated checks scale better than hand-crafted rules embedded in prompts.',
-    bitterLessonSafe: true,
-  },
-
-  {
-    name: 'Framework-specific boilerplate generation',
-    rationale:
-      'Framework CLIs and IDE scaffolds already generate boilerplate from evolving upstream knowledge. Delegating to those computational systems is safer than freezing hand-written templates into aikit instructions.',
-    bitterLessonSafe: true,
-  },
-
-  {
-    name: 'Git workflow enforcement',
-    rationale:
-      'Branch policies, commit formatting, and merge gates belong in git hooks and CI where they can be enforced automatically. Reliable computation beats informal agent-side reminders and hand-crafted behavior rules.',
-    bitterLessonSafe: true,
-  },
-
-  {
-    name: 'IDE-specific keybinding and config guidance',
-    rationale:
-      'Editor shortcuts, panel layouts, and workspace settings are IDE concerns that change across clients and teams. Runtime tooling and local editor config are the right computational layer, not static agent instructions.',
-    bitterLessonSafe: true,
-  },
-
-  {
-    name: 'Package manager lock file manipulation',
-    rationale:
-      'Lock files should be produced by the package manager and verified in CI or release pipelines, not manually curated by agent policy. Deterministic tool execution is more robust than hand-crafted lockfile guidance.',
-    bitterLessonSafe: true,
-  },
-
-  {
-    name: 'Hard-coded file naming conventions',
-    rationale:
-      'Naming rules vary by repository and should live in project generators, linters, or review automation. Letting configurable computation enforce conventions scales better than embedding brittle file-name doctrine in prompts.',
-    bitterLessonSafe: true,
-  },
-
-  {
-    name: 'Runtime environment variable validation',
-    rationale:
-      'Environment validation belongs in application startup code, schemas, and deployment checks where real runtime state is available. Computed validation with executable code outperforms hand-crafted agent assumptions about env shape.',
-    bitterLessonSafe: true,
-  },
-];

package/scaffold/definitions/hooks.mjs

@@ -1,43 +0,0 @@
-/**
- * Hook definitions — lifecycle events that agents can respond to.
- *
- * Not all IDEs support hooks natively:
- *   - Copilot: No native hook support (hooks are documented in instructions only)
- *   - Claude Code: Maps to hooks config in settings.json
- *   - Claude Code: Supports hooks via settings.json
- *
- * Each adapter decides how to surface these:
- *   - Copilot adapter: Embeds as rules in copilot-instructions.md
- *   - Claude Code adapter: Generates hooks config [future]
- */
-
-export const HOOKS = {
-  sessionStart: {
-    description: 'Run at the start of every agent session',
-    actions: ['status({})', 'list()', 'search({ query: "SESSION CHECKPOINT", origin: "curated" })'],
-    rationale: 'Resume prior work, load existing knowledge',
-  },
-
-  sessionEnd: {
-    description: 'Run at the end of every agent session',
-    actions: [
-      'remember({ title: "Session checkpoint: <topic>", content: "<decisions, next steps>", category: "conventions" })',
-    ],
-    rationale: 'Persist decisions for future sessions',
-  },
-
-  beforeCodeChange: {
-    description: 'Run before modifying any code',
-    actions: [
-      'search({ query: "<what you are changing>" })',
-      'scope_map({ task: "<description>" })',
-    ],
-    rationale: 'Check for prior decisions and understand impact',
-  },
-
-  beforeCommit: {
-    description: 'Run before committing changes',
-    actions: ['check({})', 'test_run({})', 'blast_radius({ changed_files: ["..."] })'],
-    rationale: 'Validate changes before they enter version control',
-  },
-};

package/scaffold/definitions/models.mjs

@@ -1,84 +0,0 @@
-/**
- * Centralized model assignments — THE SINGLE FILE to update when models change.
- *
- * Keys are agent names (stable, model-agnostic).
- * COPILOT_MODELS keeps the full fallback list in Copilot format.
- * CLAUDE_MODELS maps each agent to its primary model as a single plain string.
- *
- * Naming convention for variants: {Role}-Alpha, {Role}-Beta, {Role}-Gamma, {Role}-Delta
- * These are abstract labels — the actual model behind each is defined HERE.
- *
- * NOTE (Experimental): VS Code supports a model array syntax (e.g. [model1, model2])
- * for agent files, but it requires an experiment flag to be enabled. Until the flag
- * is generally available, adapters should emit only the first (primary) model as a
- * plain string. The full fallback arrays are retained here so adapters can switch to
- * array output when the flag is GA.
- */
-
-export const COPILOT_MODELS = {
-  // ─── Single-role agents ───────────────────────────────────────────────
-  Orchestrator: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
-  Planner: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
-  Implementer: [
-    'GPT-5.4 (copilot)',
-    'Gemini 3.1 Pro (Preview) (copilot)',
-    'GPT-5.3-Codex (copilot)',
-    'Auto (copilot)',
-  ],
-  Frontend: [
-    'Gemini 3.1 Pro (Preview) (copilot)',
-    'GPT-5.4 (copilot)',
-    'GPT-5.3-Codex (copilot)',
-    'Auto (copilot)',
-  ],
-  Debugger: [
-    'Claude Opus 4.6 (copilot)',
-    'GPT-5.4 (copilot)',
-    'GPT-5.3-Codex (copilot)',
-    'Auto (copilot)',
-  ],
-  Refactor: ['GPT-5.4 (copilot)', 'GPT-5.3-Codex (copilot)', 'Auto (copilot)'],
-  Security: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
-  Documenter: ['GPT-5.4 (copilot)', 'Gemini 3.1 Pro (Preview) (copilot)', 'Auto (copilot)'],
-  Explorer: ['Gemini 3 Flash (Preview) (copilot)', 'Claude Haiku 4.5 (copilot)', 'Auto (copilot)'],
-
-  // ─── Researcher variants (4 models for multi-model decision protocol) ────────────
-  'Researcher-Alpha': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
-  'Researcher-Beta': ['Claude Sonnet 4.6 (copilot)', 'Auto (copilot)'],
-  'Researcher-Gamma': ['GPT-5.4 (copilot)', 'Auto (copilot)'],
-  'Researcher-Delta': ['Gemini 3.1 Pro (Preview) (copilot)', 'Auto (copilot)'],
-
-  // ─── Code-Reviewer variants (2 models for dual review) ───────────────
-  'Code-Reviewer-Alpha': ['GPT-5.4 (copilot)', 'Auto (copilot)'],
-  'Code-Reviewer-Beta': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
-
-  // ─── Architect-Reviewer variants (2 models for dual review) ──────────
-  'Architect-Reviewer-Alpha': ['GPT-5.4 (copilot)', 'Auto (copilot)'],
-  'Architect-Reviewer-Beta': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
-};
-
-export const CLAUDE_MODELS = Object.fromEntries(
-  Object.entries(COPILOT_MODELS).map(([agentName, models]) => {
-    const primaryModel = Array.isArray(models) ? models[0] : models;
-    return [agentName, primaryModel?.replace(/ \(copilot\)$/, '') || 'Auto'];
-  }),
-);
-
-/**
- * Variant group definitions — maps role to variant suffixes.
- * Used by adapters to know which agents are variants of the same role.
- */
-export const VARIANT_GROUPS = {
-  Researcher: ['Alpha', 'Beta', 'Gamma', 'Delta'],
-  'Code-Reviewer': ['Alpha', 'Beta'],
-  'Architect-Reviewer': ['Alpha', 'Beta'],
-};
-
-/**
- * Primary variant per role — the "default" one for single-agent invocation.
- */
-export const PRIMARY_VARIANT = {
-  Researcher: 'Alpha',
-  'Code-Reviewer': 'Alpha',
-  'Architect-Reviewer': 'Alpha',
-};

package/scaffold/definitions/plugins.mjs

@@ -1,147 +0,0 @@
-/**
- * Plugin/skill definitions — packages of domain knowledge for agents.
- *
- * Copilot: .github/skills/{name}/SKILL.md
- * Claude Code: Maps to tool_use permissions and MCP config
- * Claude Code: Referenced via CLAUDE.md or MCP
- *
- * Skills are NOT generated — they live in scaffold/skills/.
- * This file defines WHICH skills to copy and their metadata.
- */
-
-export const PLUGINS = {
-  aikit: {
-    description: 'AI Kit search, analysis, memory, and developer tools',
-    source: 'scaffold/skills/aikit/SKILL.md',
-    required: true,
-  },
-
-  brainstorming: {
-    description: 'Brainstorming & design exploration workflow',
-    source: 'scaffold/skills/brainstorming/SKILL.md',
-    required: true,
-    sidecars: ['scaffold/skills/brainstorming/spec-document-reviewer-prompt.md'],
-  },
-
-  'multi-agents-development': {
-    description:
-      'Multi-agent orchestration, task decomposition, parallel dispatch, and review pipeline patterns',
-    source: 'scaffold/skills/multi-agents-development/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/multi-agents-development/implementer-prompt.md',
-      'scaffold/skills/multi-agents-development/spec-review-prompt.md',
-      'scaffold/skills/multi-agents-development/code-quality-review-prompt.md',
-      'scaffold/skills/multi-agents-development/architecture-review-prompt.md',
-      'scaffold/skills/multi-agents-development/parallel-dispatch-example.md',
-    ],
-  },
-
-  'adr-skill': {
-    description:
-      'Architecture Decision Records — create, maintain, and review ADRs for significant technical decisions',
-    source: 'scaffold/skills/adr-skill/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/adr-skill/assets/templates/adr-madr.md',
-      'scaffold/skills/adr-skill/assets/templates/adr-readme.md',
-      'scaffold/skills/adr-skill/assets/templates/adr-simple.md',
-      'scaffold/skills/adr-skill/references/adr-conventions.md',
-      'scaffold/skills/adr-skill/references/examples.md',
-      'scaffold/skills/adr-skill/references/review-checklist.md',
-      'scaffold/skills/adr-skill/references/template-variants.md',
-      'scaffold/skills/adr-skill/scripts/bootstrap_adr.js',
-      'scaffold/skills/adr-skill/scripts/new_adr.js',
-      'scaffold/skills/adr-skill/scripts/set_adr_status.js',
-    ],
-  },
-
-  'c4-architecture': {
-    description:
-      'C4 model architecture diagrams using Mermaid — system context, container, component, and deployment views',
-    source: 'scaffold/skills/c4-architecture/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/c4-architecture/references/advanced-patterns.md',
-      'scaffold/skills/c4-architecture/references/c4-syntax.md',
-      'scaffold/skills/c4-architecture/references/common-mistakes.md',
-    ],
-  },
-
-  'frontend-design': {
-    description:
-      'Frontend design system — visual design thinking, typography, color, layout, motion, accessibility, and anti-pattern detection',
-    source: 'scaffold/skills/frontend-design/SKILL.md',
-    required: false,
-  },
-
-  'lesson-learned': {
-    description: 'Extract engineering lessons from recent code changes via git history analysis',
-    source: 'scaffold/skills/lesson-learned/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/lesson-learned/references/anti-patterns.md',
-      'scaffold/skills/lesson-learned/references/se-principles.md',
-    ],
-  },
-
-  present: {
-    description:
-      'Rich interactive dashboards, charts, tables, timelines, and data visualizations via the present MCP tool',
-    source: 'scaffold/skills/present/SKILL.md',
-    required: true,
-  },
-
-  react: {
-    description:
-      'React development patterns — component architecture, React 19 APIs, Server Components, TypeScript integration',
-    source: 'scaffold/skills/react/SKILL.md',
-    required: false,
-  },
-
-  'requirements-clarity': {
-    description:
-      'Clarify ambiguous requirements through focused dialogue — score 0-100 until ≥90 before implementation',
-    source: 'scaffold/skills/requirements-clarity/SKILL.md',
-    required: true,
-  },
-
-  'session-handoff': {
-    description:
-      'Comprehensive handoff documents for seamless AI agent session transfers and context preservation',
-    source: 'scaffold/skills/session-handoff/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/session-handoff/references/handoff-template.md',
-      'scaffold/skills/session-handoff/references/resume-checklist.md',
-      'scaffold/skills/session-handoff/scripts/check_staleness.js',
-      'scaffold/skills/session-handoff/scripts/create_handoff.js',
-      'scaffold/skills/session-handoff/scripts/list_handoffs.js',
-      'scaffold/skills/session-handoff/scripts/validate_handoff.js',
-    ],
-  },
-
-  typescript: {
-    description:
-      'TypeScript development patterns — type system, compiler config, advanced types, async patterns, module organization',
-    source: 'scaffold/skills/typescript/SKILL.md',
-    required: false,
-  },
-  docs: {
-    description:
-      'Living documentation management — Diátaxis framework, docs/ convention, staleness detection, integration with adr-skill and c4-architecture',
-    source: 'scaffold/skills/docs/SKILL.md',
-    required: true,
-  },
-
-  'repo-access': {
-    description:
-      'Progressive repository access recovery for private and enterprise git repos — strategy ladder from HTTPS to SSH to CLI OAuth to PAT to local clone',
-    source: 'scaffold/skills/repo-access/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/repo-access/references/platform-matrix.md',
-      'scaffold/skills/repo-access/references/error-patterns.md',
-    ],
-  },
-};