diff --git a/.agentkit/engines/node/src/synchronize.mjs b/.agentkit/engines/node/src/synchronize.mjs index 8cd62c65..0087c19c 100644 --- a/.agentkit/engines/node/src/synchronize.mjs +++ b/.agentkit/engines/node/src/synchronize.mjs @@ -2006,6 +2006,8 @@ export async function runSync({ agentkitRoot, projectRoot, flags }) { overlaySettings.repoName || repoName, defaultBranch: overlaySettings.defaultBranch || 'main', + integrationBranch: + overlaySettings.integrationBranch || overlaySettings.defaultBranch || 'main', primaryStack: overlaySettings.primaryStack || 'auto', commandPrefix: overlaySettings.commandPrefix || null, syncDate: new Date().toISOString().slice(0, 10), diff --git a/.agentkit/overlays/__TEMPLATE__/settings.yaml b/.agentkit/overlays/__TEMPLATE__/settings.yaml index f805f68e..00f11441 100644 --- a/.agentkit/overlays/__TEMPLATE__/settings.yaml +++ b/.agentkit/overlays/__TEMPLATE__/settings.yaml @@ -1,7 +1,8 @@ # Repo-specific overlay settings # This file is copied by `agentkit init` and customized per repo. repoName: __TEMPLATE__ -defaultBranch: main +defaultBranch: main # Repository default branch (usually main or master) +integrationBranch: main # Branch PRs should target (often dev or main; defaults to defaultBranch) primaryStack: auto windowsFirst: true diff --git a/.agentkit/overlays/retort/settings.yaml b/.agentkit/overlays/retort/settings.yaml new file mode 100644 index 00000000..aec890d0 --- /dev/null +++ b/.agentkit/overlays/retort/settings.yaml @@ -0,0 +1,24 @@ +# Retort repo overlay settings +# This is retort's own overlay — configures how the framework generates output for itself. +repoName: retort +defaultBranch: main # Production branch — never commit directly +integrationBranch: dev # PRs must target dev, not main +primaryStack: auto +windowsFirst: true + +aiSynthesisLayer: false + +renderTargets: + - claude + - cursor + - windsurf + - copilot + - gemini + - codex + - warp + - cline + - roo + - ai + - mcp + +featurePreset: standard diff --git a/.agentkit/templates/claude/CLAUDE.md b/.agentkit/templates/claude/CLAUDE.md index 3507efdb..ec7535b0 100644 --- a/.agentkit/templates/claude/CLAUDE.md +++ b/.agentkit/templates/claude/CLAUDE.md @@ -12,6 +12,7 @@ This repository uses **Retort** to manage AI agent team workflows across multipl - **Repository**: {{repoName}} - **Default Branch**: {{defaultBranch}} +- **Integration Branch** (PR target): {{integrationBranch}} - **Framework Version**: {{version}} {{#if projectPhase}} @@ -356,6 +357,16 @@ Then commit the regenerated output. The CI drift check **will fail** if generate Feature branches: `type/short-description` (e.g., `feat/add-user-auth`, `fix/token-refresh`) +### PR Target Branch + +All PRs **must** target `{{integrationBranch}}` — not `{{defaultBranch}}` or any other branch unless explicitly instructed: + +```bash +gh pr create --base {{integrationBranch}} --title "type(scope): description" +``` + +The integration branch (`{{integrationBranch}}`) is the configured PR target for this repo. Creating PRs against `{{defaultBranch}}` directly causes reverse-merge noise and bypasses the integration pipeline. A hookify rule in `.claude/rules/pr-base-branch.md` enforces this at runtime. + ## Safety Rules 1. **Never** commit secrets, API keys, or credentials diff --git a/.agentkit/templates/claude/hooks/protect-templates.ps1 b/.agentkit/templates/claude/hooks/protect-templates.ps1 index 773dc0fd..5ffd9dc1 100644 --- a/.agentkit/templates/claude/hooks/protect-templates.ps1 +++ b/.agentkit/templates/claude/hooks/protect-templates.ps1 @@ -52,7 +52,7 @@ $protectedPatterns = @( foreach ($pattern in $protectedPatterns) { if ($filePath -match $pattern) { - $reason = "Blocked: '$filePath' is an Retort source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run 'pnpm -C .agentkit retort:sync'." + $reason = "Blocked: '$filePath' is a Retort source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run 'pnpm -C .agentkit retort:sync'." @{ hookSpecificOutput = @{ hookEventName = 'PreToolUse' diff --git a/.agentkit/templates/claude/hooks/protect-templates.sh b/.agentkit/templates/claude/hooks/protect-templates.sh index de961749..502fecd0 100755 --- a/.agentkit/templates/claude/hooks/protect-templates.sh +++ b/.agentkit/templates/claude/hooks/protect-templates.sh @@ -47,7 +47,7 @@ PROTECTED_PATTERNS=( for pattern in "${PROTECTED_PATTERNS[@]}"; do if echo "$FILE_PATH" | grep -qE "$pattern"; then jq -n \ - --arg reason "Blocked: '${FILE_PATH}' is an Retort source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run '{{packageManager}} -C .agentkit retort:sync'." \ + --arg reason "Blocked: '${FILE_PATH}' is a Retort source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run '{{packageManager}} -C .agentkit retort:sync'." \ '{ hookSpecificOutput: { hookEventName: "PreToolUse", diff --git a/.agentkit/templates/claude/rules/pr-base-branch.md b/.agentkit/templates/claude/rules/pr-base-branch.md new file mode 100644 index 00000000..4d3f8520 --- /dev/null +++ b/.agentkit/templates/claude/rules/pr-base-branch.md @@ -0,0 +1,50 @@ + + + + + + +# PR Base Branch Guard + +Always use `--base {{integrationBranch}}` when creating pull requests in **{{repoName}}**. + +## Rule + +**Event**: bash +**Action**: warn +**Pattern**: `gh pr create` without `--base {{integrationBranch}}` + +## Why This Matters + +This repository uses a two-branch model: + +- `{{defaultBranch}}` — production branch, never targeted directly by feature PRs +- `{{integrationBranch}}` — integration branch, the correct PR target for all feature work + +Creating PRs against `{{defaultBranch}}` instead of `{{integrationBranch}}` triggers an automatic reverse-merge PR (merging `{{defaultBranch}}` back into `{{integrationBranch}}`), which creates noise and bypasses the integration pipeline. + +## Correct Usage + +```bash +# Always specify --base explicitly +gh pr create --base {{integrationBranch}} --title "type(scope): description" +``` + +## Incorrect Usage + +```bash +# These will target the wrong branch +gh pr create --title "type(scope): description" +gh pr create --base {{defaultBranch}} --title "type(scope): description" +``` + +## Configuration + +The integration branch is configured in `.agentkit/overlays/{{repoName}}/settings.yaml`: + +```yaml +defaultBranch: {{defaultBranch}} +integrationBranch: {{integrationBranch}} +``` + +To change the integration branch, update `settings.yaml` and run `pnpm -C .agentkit retort:sync`. diff --git a/.agents/skills/analyze-agents/SKILL.md b/.agents/skills/analyze-agents/SKILL.md index d145f285..c4c9daf7 100644 --- a/.agents/skills/analyze-agents/SKILL.md +++ b/.agents/skills/analyze-agents/SKILL.md @@ -3,14 +3,14 @@ name: 'analyze-agents' description: 'Generates a comprehensive agent/team relationship matrix. Analyzes dependencies, notifications, handoffs, coverage gaps, bottlenecks, and consolidation opportunities across all teams and agents.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # analyze-agents @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `analyze-agents` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/backlog/SKILL.md b/.agents/skills/backlog/SKILL.md index d95db7b0..3e053fc5 100644 --- a/.agents/skills/backlog/SKILL.md +++ b/.agents/skills/backlog/SKILL.md @@ -3,14 +3,14 @@ name: 'backlog' description: 'Displays a consolidated backlog view from all sources (external tracker, discovery, healthcheck, code TODOs, review findings, manual entries). Supports filtering and multiple output formats for CLI and future UI consumption.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # backlog @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `backlog` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/brand/SKILL.md b/.agents/skills/brand/SKILL.md index 5a7bfd2f..4bb4a6f6 100644 --- a/.agents/skills/brand/SKILL.md +++ b/.agents/skills/brand/SKILL.md @@ -3,14 +3,14 @@ name: 'brand' description: 'Manage the project brand spec (brand.yaml) and editor theme. Supports validation, palette preview, theme mapping, contrast auditing, scaffolding, and regeneration of editor theme files.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # brand @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `brand` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/build/SKILL.md b/.agents/skills/build/SKILL.md index 9c3502e8..34b17717 100644 --- a/.agents/skills/build/SKILL.md +++ b/.agents/skills/build/SKILL.md @@ -3,14 +3,14 @@ name: 'build' description: 'Builds the project using the detected tech stack's build command. Supports targeting specific packages in a monorepo or building the entire workspace.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # build @@ -59,7 +59,7 @@ Report: detected stack, scope, exact command, status (PASS/FAIL), duration, arti ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/check/SKILL.md b/.agents/skills/check/SKILL.md index 4f7a844b..40c00305 100644 --- a/.agents/skills/check/SKILL.md +++ b/.agents/skills/check/SKILL.md @@ -3,14 +3,14 @@ name: 'check' description: 'Runs all quality checks for the repository: type checking, linting, formatting validation, and test suites. Returns a unified pass/fail status with detailed breakdowns per check category.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # check @@ -51,7 +51,7 @@ Produce: Quality Gate Results table (Step | Status | Duration | Details), Overal ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/cost-centres/SKILL.md b/.agents/skills/cost-centres/SKILL.md index 7d59db74..735fd3a8 100644 --- a/.agents/skills/cost-centres/SKILL.md +++ b/.agents/skills/cost-centres/SKILL.md @@ -3,14 +3,14 @@ name: 'cost-centres' description: 'Cost centre management for cloud infrastructure. Manages budget allocations, resource group mappings, tag compliance, and spend tracking. Requires a FinOps-enabled overlay (finops rule domain). For AI session cost tracking, use /cost instead.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # cost-centres @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `cost-centres` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/cost/SKILL.md b/.agents/skills/cost/SKILL.md index d691d3e7..67a30e81 100644 --- a/.agents/skills/cost/SKILL.md +++ b/.agents/skills/cost/SKILL.md @@ -3,14 +3,14 @@ name: 'cost' description: 'Session cost and usage tracking. Shows session summaries, lists recent sessions, and generates aggregate usage reports. Tracks session duration, commands run, and files modified via lifecycle hooks.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # cost @@ -44,7 +44,7 @@ Invoke this skill when you need to perform the `cost` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/deploy/SKILL.md b/.agents/skills/deploy/SKILL.md index d5b789cc..159c6279 100644 --- a/.agents/skills/deploy/SKILL.md +++ b/.agents/skills/deploy/SKILL.md @@ -3,14 +3,14 @@ name: 'deploy' description: 'Triggers a deployment pipeline or generates deployment artifacts. Validates pre-deployment checks (build, test, lint) before proceeding. Supports dry-run mode for safety.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # deploy @@ -65,7 +65,7 @@ Report: service, environment, platform, status, timeline, command output, post-d ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/discover/SKILL.md b/.agents/skills/discover/SKILL.md index 1df635d1..d8262bfe 100644 --- a/.agents/skills/discover/SKILL.md +++ b/.agents/skills/discover/SKILL.md @@ -3,14 +3,14 @@ name: 'discover' description: 'Scans the repository to build a comprehensive understanding of the project structure, tech stacks in use, team boundaries, and architectural patterns. Outputs a structured discovery report used by other commands.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # discover @@ -47,7 +47,7 @@ Create or update `AGENT_TEAMS.md` with: Repository Profile (primary stack, build ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/doctor/SKILL.md b/.agents/skills/doctor/SKILL.md index a3e2f0d7..e9c8b666 100644 --- a/.agents/skills/doctor/SKILL.md +++ b/.agents/skills/doctor/SKILL.md @@ -3,14 +3,14 @@ name: 'doctor' description: 'Runs AgentKit Forge diagnostics: spec validation, overlay sanity checks, template availability, project.yaml completeness hints, and suggested next actions for fixing setup issues.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # doctor @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `doctor` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/document-history/SKILL.md b/.agents/skills/document-history/SKILL.md index c2d07f9c..125dbadb 100644 --- a/.agents/skills/document-history/SKILL.md +++ b/.agents/skills/document-history/SKILL.md @@ -3,14 +3,14 @@ name: 'document-history' description: 'Creates a structured history document from templates for significant work completed in the current session. Supports bug fixes, features, implementations, and migrations. Auto-detects type and title from git history when invoked without arguments. Fills in all template sections with concrete details from session context.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # document-history @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `document-history` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/expand/SKILL.md b/.agents/skills/expand/SKILL.md index 5a9dea80..0716c8d1 100644 --- a/.agents/skills/expand/SKILL.md +++ b/.agents/skills/expand/SKILL.md @@ -3,14 +3,14 @@ name: 'expand' description: 'Runs the expansion analyzer to identify gaps, missing capabilities, undocumented decisions, and improvement opportunities in the codebase. Produces a ranked list of suggestions with rationale, impact scores, and effort estimates. Never creates tasks in analysis mode — all suggestions require explicit human approval. Use --save to persist suggestions to disk for later review.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # expand @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `expand` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/feature-configure/SKILL.md b/.agents/skills/feature-configure/SKILL.md index be8006d8..65d815fb 100644 --- a/.agents/skills/feature-configure/SKILL.md +++ b/.agents/skills/feature-configure/SKILL.md @@ -3,14 +3,14 @@ name: 'feature-configure' description: 'Interactive feature configuration workflow. Walks through each feature category, explains what each feature provides, shows current status, and applies changes via the overlay settings.yaml. Triggers a sync after changes are applied.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # feature-configure @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `feature-configure` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/feature-flow/SKILL.md b/.agents/skills/feature-flow/SKILL.md index 71e787f0..fe6cedf2 100644 --- a/.agents/skills/feature-flow/SKILL.md +++ b/.agents/skills/feature-flow/SKILL.md @@ -3,14 +3,14 @@ name: 'feature-flow' description: 'Traces a specific feature end-to-end through the kit: shows which spec files define it, which template vars it injects, which templates consume those vars, what generated output it produces, and what overlay settings control it. Use this to understand or debug a feature's behavior.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # feature-flow @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `feature-flow` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/feature-review/SKILL.md b/.agents/skills/feature-review/SKILL.md index 0e5962ab..c75496ca 100644 --- a/.agents/skills/feature-review/SKILL.md +++ b/.agents/skills/feature-review/SKILL.md @@ -3,14 +3,14 @@ name: 'feature-review' description: 'Reviews the current feature configuration for the repo. Analyzes which features are enabled/disabled, checks for misconfigured dependencies, identifies unused features (enabled but no matching code patterns), and recommends features to enable based on codebase analysis.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # feature-review @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `feature-review` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/format/SKILL.md b/.agents/skills/format/SKILL.md index e7b485c3..8ed122d8 100644 --- a/.agents/skills/format/SKILL.md +++ b/.agents/skills/format/SKILL.md @@ -3,14 +3,14 @@ name: 'format' description: 'Formats code using the detected tech stack's formatter. Can target specific files, directories, or the entire workspace. Reports files that were changed.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # format @@ -56,7 +56,7 @@ Report: formatters run, scope, mode, files changed/needing formatting, summary c ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/import-issues/SKILL.md b/.agents/skills/import-issues/SKILL.md index a8fdeffa..b38a5c1b 100644 --- a/.agents/skills/import-issues/SKILL.md +++ b/.agents/skills/import-issues/SKILL.md @@ -3,14 +3,14 @@ name: 'import-issues' description: 'Imports issues from the configured external tracker (GitHub or Linear), normalizes fields to the canonical backlog schema, deduplicates against existing items, assigns teams via intake routing rules, and merges into AGENT_BACKLOG.md and .claude/state/backlog.json. Gated behind the process.intake.autoImport flag (can be overridden with --force).' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # import-issues @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `import-issues` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/infra-eval/SKILL.md b/.agents/skills/infra-eval/SKILL.md index ba979606..a548792e 100644 --- a/.agents/skills/infra-eval/SKILL.md +++ b/.agents/skills/infra-eval/SKILL.md @@ -3,14 +3,14 @@ name: 'infra-eval' description: 'Risk-aware infrastructure and codebase evaluation against reliability, cost, and scale fitness. Scores eight weighted dimensions (0–5 each), enforces hard gates for critical safety properties, and produces a scored summary with narrative risk analysis. Designed for quarterly reassessment, pre-funding due diligence, and architectural decision support. Gated behind the evaluation.infraEval project.yaml flag.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # infra-eval @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `infra-eval` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/orchestrate/SKILL.md b/.agents/skills/orchestrate/SKILL.md index 8afa03d8..c0f7acd2 100644 --- a/.agents/skills/orchestrate/SKILL.md +++ b/.agents/skills/orchestrate/SKILL.md @@ -3,14 +3,14 @@ name: 'orchestrate' description: 'Top-level orchestration command. Assesses the current repository state, identifies work to be done, delegates to appropriate team agents, and synthesizes results. The primary entry point for multi-step workflows.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # orchestrate @@ -55,7 +55,7 @@ Produce a summary with: Actions Taken, Files Changed, Validation Commands, Updat ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/plan/SKILL.md b/.agents/skills/plan/SKILL.md index b965a785..3c2b6250 100644 --- a/.agents/skills/plan/SKILL.md +++ b/.agents/skills/plan/SKILL.md @@ -3,14 +3,14 @@ name: 'plan' description: 'Creates a detailed implementation plan for a feature, bug fix, or refactoring task. Analyzes the codebase, identifies affected files and teams, estimates complexity, and produces a step-by-step plan with acceptance criteria.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # plan @@ -45,7 +45,7 @@ You are the **Planning Agent**. Produce detailed, structured implementation plan ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/preflight/SKILL.md b/.agents/skills/preflight/SKILL.md index 13c149ff..82637b16 100644 --- a/.agents/skills/preflight/SKILL.md +++ b/.agents/skills/preflight/SKILL.md @@ -3,14 +3,14 @@ name: 'preflight' description: 'Runs enhanced delivery checks before ship: quality gates, changelog, coverage delta, commit convention conformance, TODO/FIXME hygiene, and documentation updates for externally visible changes.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # preflight @@ -41,7 +41,7 @@ If `--range` is omitted, auto-detect via merge-base against the default branch. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/project-status/SKILL.md b/.agents/skills/project-status/SKILL.md index 30c8fcc7..9366e5bb 100644 --- a/.agents/skills/project-status/SKILL.md +++ b/.agents/skills/project-status/SKILL.md @@ -3,14 +3,14 @@ name: 'project-status' description: 'Unified PM dashboard that aggregates orchestrator state, backlog, task progress, risks, and delivery metrics into a markdown or JSON report. Provides at-a-glance visibility into project health across all teams.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # project-status @@ -120,7 +120,7 @@ Produce markdown (default) or JSON (with `--format json`) with these sections: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/review/SKILL.md b/.agents/skills/review/SKILL.md index 38a23031..2c6fab0a 100644 --- a/.agents/skills/review/SKILL.md +++ b/.agents/skills/review/SKILL.md @@ -3,14 +3,14 @@ name: 'review' description: 'Performs a structured code review of staged changes, a specific PR, or a range of commits. Evaluates code quality, adherence to domain rules, security concerns, test coverage, and architectural alignment.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # review @@ -63,7 +63,7 @@ Produce: Summary, Required Changes (must fix, with file:line references), Sugges ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/scaffold/SKILL.md b/.agents/skills/scaffold/SKILL.md index d0782a30..45d07706 100644 --- a/.agents/skills/scaffold/SKILL.md +++ b/.agents/skills/scaffold/SKILL.md @@ -3,14 +3,14 @@ name: 'scaffold' description: 'Generates implementation skeletons aligned with project conventions. Supports endpoints, UI components, IaC modules, migrations, tests, and services. Uses project.yaml context and domain rules to prefill structure and guardrails.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # scaffold @@ -41,7 +41,7 @@ Invoke this skill when you need to perform the `scaffold` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/security/SKILL.md b/.agents/skills/security/SKILL.md index 93027c78..76dd8786 100644 --- a/.agents/skills/security/SKILL.md +++ b/.agents/skills/security/SKILL.md @@ -3,14 +3,14 @@ name: 'security' description: 'Runs security-focused analysis: dependency vulnerability scanning, secret detection, OWASP compliance checks, and permission auditing. Generates a security report with severity ratings.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # security @@ -65,7 +65,7 @@ Produce: Executive Summary, Risk Score, Findings by severity (with ID, file:line ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/start/SKILL.md b/.agents/skills/start/SKILL.md index e15fb116..1331cef3 100644 --- a/.agents/skills/start/SKILL.md +++ b/.agents/skills/start/SKILL.md @@ -3,14 +3,14 @@ name: 'start' description: 'New user entry point. Detects repository state, shows contextual status, and guides users to the right command or team for their goal. Read-only — suggests commands but does not execute them.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # start @@ -114,7 +114,7 @@ This command is **read-only**. It reads state files for context detection but do ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/sync-backlog/SKILL.md b/.agents/skills/sync-backlog/SKILL.md index ea80b4fc..c30021c6 100644 --- a/.agents/skills/sync-backlog/SKILL.md +++ b/.agents/skills/sync-backlog/SKILL.md @@ -3,14 +3,14 @@ name: 'sync-backlog' description: 'Synchronizes the local backlog with the configured issue tracker (GitHub or Linear), maps findings to ownership teams, updates local tracking documents, and identifies stale or unassigned work items.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # sync-backlog @@ -62,7 +62,7 @@ Priorities: P0 (blocking), P1 (high — this session), P2 (medium), P3 (low — ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/sync/SKILL.md b/.agents/skills/sync/SKILL.md index dd5f0c03..22e76531 100644 --- a/.agents/skills/sync/SKILL.md +++ b/.agents/skills/sync/SKILL.md @@ -3,14 +3,14 @@ name: 'sync' description: 'Regenerates all AI tool configurations from the AgentKit Forge spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # sync @@ -66,7 +66,7 @@ This command requires shell access (Bash tool). On platforms with restricted too ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/test/SKILL.md b/.agents/skills/test/SKILL.md index c777bc01..864c6db0 100644 --- a/.agents/skills/test/SKILL.md +++ b/.agents/skills/test/SKILL.md @@ -3,14 +3,14 @@ name: 'test' description: 'Runs the test suite using the detected tech stack's test command. Supports filtering by test file, pattern, or package. Reports pass/fail counts and coverage when available.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # test @@ -60,7 +60,7 @@ Report: framework, scope, exact command, summary table (Total/Passed/Failed/Skip ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.agents/skills/validate/SKILL.md b/.agents/skills/validate/SKILL.md index 9b2c69ca..0eb775e0 100644 --- a/.agents/skills/validate/SKILL.md +++ b/.agents/skills/validate/SKILL.md @@ -3,14 +3,14 @@ name: 'validate' description: 'Validates generated outputs for correctness. Checks that all required directories, JSON files, command files, and hook scripts exist and are well-formed. Scans for forbidden patterns (hardcoded secrets) and verifies the settings.json hooks configuration.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Codex agent skill definition. # Docs: https://developers.openai.com/codex/guides/agents-md --- - - - + + + # validate @@ -35,7 +35,7 @@ Report: per-check pass/fail with details, overall PASS/FAIL status, list of miss ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.ai/README.md b/.ai/README.md index 2efc7b79..e97eacab 100644 --- a/.ai/README.md +++ b/.ai/README.md @@ -1,6 +1,6 @@ - + # .ai — Tool-Agnostic AI Rules diff --git a/.ai/continuerules b/.ai/continuerules index 0a7b7d68..555ce37e 100644 --- a/.ai/continuerules +++ b/.ai/continuerules @@ -5,7 +5,7 @@ Follow UNIFIED_AGENT_TEAMS.md and CLAUDE.md. Use /discover → /healthcheck → /plan → implement → /check → /review. Never modify .env, secrets, or credential files. Never modify files in .agentkit/templates/, .agentkit/spec/, .agentkit/engines/, or .agentkit/overlays/, or .agentkit/bin/ — propose changes via PR instead. -Never edit files marked "GENERATED by AgentKit Forge — DO NOT EDIT" — modify the spec and run agentkit sync. +Never edit files marked "GENERATED by Retort — DO NOT EDIT" — modify the spec and run retort sync. Prefer small, reversible changes with tests. All commits AND PR titles MUST use Conventional Commits: type(scope): description. Types: feat|fix|docs|style|refactor|test|chore|ci|perf|build|revert. Never use "Plan:", "Update", or free-form titles. -After editing .agentkit/spec/, ALWAYS run: pnpm -C .agentkit agentkit:sync — then commit the regenerated output. +After editing .agentkit/spec/, ALWAYS run: pnpm -C .agentkit retort:sync — then commit the regenerated output. diff --git a/.ai/cursorrules b/.ai/cursorrules index 1eab0fe5..48e56cc9 100644 --- a/.ai/cursorrules +++ b/.ai/cursorrules @@ -5,7 +5,7 @@ Follow UNIFIED_AGENT_TEAMS.md and CLAUDE.md. Use /discover → /healthcheck → /plan → implement → /check → /review. Never modify .env, secrets, or credential files. Never modify files in .agentkit/templates/, .agentkit/spec/, .agentkit/engines/, .agentkit/overlays/, or .agentkit/bin/ — propose changes via PR instead. -Never edit files marked "GENERATED by AgentKit Forge — DO NOT EDIT" — modify the spec and run agentkit sync. +Never edit files marked "GENERATED by Retort — DO NOT EDIT" — modify the spec and run retort sync. Prefer small, reversible changes with tests. All commits AND PR titles MUST use Conventional Commits: type(scope): description. Types: feat|fix|docs|style|refactor|test|chore|ci|perf|build|revert. Never use "Plan:", "Update", or free-form titles. -After editing .agentkit/spec/, ALWAYS run: pnpm -C .agentkit agentkit:sync — then commit the regenerated output. +After editing .agentkit/spec/, ALWAYS run: pnpm -C .agentkit retort:sync — then commit the regenerated output. diff --git a/.ai/windsurfrules b/.ai/windsurfrules index 0a7b7d68..555ce37e 100644 --- a/.ai/windsurfrules +++ b/.ai/windsurfrules @@ -5,7 +5,7 @@ Follow UNIFIED_AGENT_TEAMS.md and CLAUDE.md. Use /discover → /healthcheck → /plan → implement → /check → /review. Never modify .env, secrets, or credential files. Never modify files in .agentkit/templates/, .agentkit/spec/, .agentkit/engines/, or .agentkit/overlays/, or .agentkit/bin/ — propose changes via PR instead. -Never edit files marked "GENERATED by AgentKit Forge — DO NOT EDIT" — modify the spec and run agentkit sync. +Never edit files marked "GENERATED by Retort — DO NOT EDIT" — modify the spec and run retort sync. Prefer small, reversible changes with tests. All commits AND PR titles MUST use Conventional Commits: type(scope): description. Types: feat|fix|docs|style|refactor|test|chore|ci|perf|build|revert. Never use "Plan:", "Update", or free-form titles. -After editing .agentkit/spec/, ALWAYS run: pnpm -C .agentkit agentkit:sync — then commit the regenerated output. +After editing .agentkit/spec/, ALWAYS run: pnpm -C .agentkit retort:sync — then commit the regenerated output. diff --git a/.claude/agents/adoption-strategist.md b/.claude/agents/adoption-strategist.md index 883ab8ee..fac7d213 100644 --- a/.claude/agents/adoption-strategist.md +++ b/.claude/agents/adoption-strategist.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/backend.md b/.claude/agents/backend.md index 62f4e83c..bc928de3 100644 --- a/.claude/agents/backend.md +++ b/.claude/agents/backend.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/brand-guardian.md b/.claude/agents/brand-guardian.md index 33aa38a0..3af5f706 100644 --- a/.claude/agents/brand-guardian.md +++ b/.claude/agents/brand-guardian.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/content-strategist.md b/.claude/agents/content-strategist.md index 36b4a36a..49615632 100644 --- a/.claude/agents/content-strategist.md +++ b/.claude/agents/content-strategist.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/cost-ops-monitor.md b/.claude/agents/cost-ops-monitor.md index 46c9ace7..80d56173 100644 --- a/.claude/agents/cost-ops-monitor.md +++ b/.claude/agents/cost-ops-monitor.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/coverage-tracker.md b/.claude/agents/coverage-tracker.md index 42af70bf..a8e53d05 100644 --- a/.claude/agents/coverage-tracker.md +++ b/.claude/agents/coverage-tracker.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/data.md b/.claude/agents/data.md index a7369ab5..0010f61b 100644 --- a/.claude/agents/data.md +++ b/.claude/agents/data.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/dependency-watcher.md b/.claude/agents/dependency-watcher.md index 3a5e24a9..12265591 100644 --- a/.claude/agents/dependency-watcher.md +++ b/.claude/agents/dependency-watcher.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/devops.md b/.claude/agents/devops.md index 59d2e4a8..92dad998 100644 --- a/.claude/agents/devops.md +++ b/.claude/agents/devops.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/environment-manager.md b/.claude/agents/environment-manager.md index 83dde028..b2252596 100644 --- a/.claude/agents/environment-manager.md +++ b/.claude/agents/environment-manager.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/expansion-analyst.md b/.claude/agents/expansion-analyst.md index b964c4cb..60925f30 100644 --- a/.claude/agents/expansion-analyst.md +++ b/.claude/agents/expansion-analyst.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/feature-ops.md b/.claude/agents/feature-ops.md index f4fb606e..461c02e2 100644 --- a/.claude/agents/feature-ops.md +++ b/.claude/agents/feature-ops.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/flow-designer.md b/.claude/agents/flow-designer.md index f5494c87..1f5a35c2 100644 --- a/.claude/agents/flow-designer.md +++ b/.claude/agents/flow-designer.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/frontend.md b/.claude/agents/frontend.md index 0ab8b5e1..7c7e2f7d 100644 --- a/.claude/agents/frontend.md +++ b/.claude/agents/frontend.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/governance-advisor.md b/.claude/agents/governance-advisor.md index abe70f41..870c44d3 100644 --- a/.claude/agents/governance-advisor.md +++ b/.claude/agents/governance-advisor.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/grant-hunter.md b/.claude/agents/grant-hunter.md index 8e4e8317..ce82a449 100644 --- a/.claude/agents/grant-hunter.md +++ b/.claude/agents/grant-hunter.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/growth-analyst.md b/.claude/agents/growth-analyst.md index d1ae3cc7..ae2c1d62 100644 --- a/.claude/agents/growth-analyst.md +++ b/.claude/agents/growth-analyst.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/impact-assessor.md b/.claude/agents/impact-assessor.md index e7c3d68e..c00101e2 100644 --- a/.claude/agents/impact-assessor.md +++ b/.claude/agents/impact-assessor.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/infra.md b/.claude/agents/infra.md index 9700b832..da33b9dc 100644 --- a/.claude/agents/infra.md +++ b/.claude/agents/infra.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/input-clarifier.md b/.claude/agents/input-clarifier.md index c462e1bf..8f713736 100644 --- a/.claude/agents/input-clarifier.md +++ b/.claude/agents/input-clarifier.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/integration-tester.md b/.claude/agents/integration-tester.md index 9ba3134d..57e8fa79 100644 --- a/.claude/agents/integration-tester.md +++ b/.claude/agents/integration-tester.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/mission-definer.md b/.claude/agents/mission-definer.md index 26892922..fa32378b 100644 --- a/.claude/agents/mission-definer.md +++ b/.claude/agents/mission-definer.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/model-economist.md b/.claude/agents/model-economist.md index de14e84d..0d8f3d5f 100644 --- a/.claude/agents/model-economist.md +++ b/.claude/agents/model-economist.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/portfolio-analyst.md b/.claude/agents/portfolio-analyst.md index a39c9c14..7e55cb46 100644 --- a/.claude/agents/portfolio-analyst.md +++ b/.claude/agents/portfolio-analyst.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/product-manager.md b/.claude/agents/product-manager.md index c1ce519e..e8bf0352 100644 --- a/.claude/agents/product-manager.md +++ b/.claude/agents/product-manager.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/project-shipper.md b/.claude/agents/project-shipper.md index 75a8ae28..9c301583 100644 --- a/.claude/agents/project-shipper.md +++ b/.claude/agents/project-shipper.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/prompt-engineer.md b/.claude/agents/prompt-engineer.md index d5c539cf..6ab9b7d5 100644 --- a/.claude/agents/prompt-engineer.md +++ b/.claude/agents/prompt-engineer.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/release-coordinator.md b/.claude/agents/release-coordinator.md index c0023b93..f4847f21 100644 --- a/.claude/agents/release-coordinator.md +++ b/.claude/agents/release-coordinator.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/release-manager.md b/.claude/agents/release-manager.md index d418d31a..5b212aa1 100644 --- a/.claude/agents/release-manager.md +++ b/.claude/agents/release-manager.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/retrospective-analyst.md b/.claude/agents/retrospective-analyst.md index 538f8596..8d4e41e0 100644 --- a/.claude/agents/retrospective-analyst.md +++ b/.claude/agents/retrospective-analyst.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/roadmap-tracker.md b/.claude/agents/roadmap-tracker.md index f6c43f2c..ab0b81ae 100644 --- a/.claude/agents/roadmap-tracker.md +++ b/.claude/agents/roadmap-tracker.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/role-architect.md b/.claude/agents/role-architect.md index 004c755b..6ccd45d8 100644 --- a/.claude/agents/role-architect.md +++ b/.claude/agents/role-architect.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/security-auditor.md b/.claude/agents/security-auditor.md index bb36e17e..36ffb8c3 100644 --- a/.claude/agents/security-auditor.md +++ b/.claude/agents/security-auditor.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/spec-compliance-auditor.md b/.claude/agents/spec-compliance-auditor.md index 662a33a9..d07f81e5 100644 --- a/.claude/agents/spec-compliance-auditor.md +++ b/.claude/agents/spec-compliance-auditor.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/team-validator.md b/.claude/agents/team-validator.md index 9b36533e..0522105b 100644 --- a/.claude/agents/team-validator.md +++ b/.claude/agents/team-validator.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/test-lead.md b/.claude/agents/test-lead.md index 9c3b3363..cb4a8eeb 100644 --- a/.claude/agents/test-lead.md +++ b/.claude/agents/test-lead.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/token-efficiency-engineer.md b/.claude/agents/token-efficiency-engineer.md index fa6a2480..72606c0e 100644 --- a/.claude/agents/token-efficiency-engineer.md +++ b/.claude/agents/token-efficiency-engineer.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/ui-designer.md b/.claude/agents/ui-designer.md index 20b058e8..a26e29ac 100644 --- a/.claude/agents/ui-designer.md +++ b/.claude/agents/ui-designer.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/agents/vendor-arbitrage-analyst.md b/.claude/agents/vendor-arbitrage-analyst.md index b977262e..814f68b4 100644 --- a/.claude/agents/vendor-arbitrage-analyst.md +++ b/.claude/agents/vendor-arbitrage-analyst.md @@ -1,4 +1,4 @@ - + diff --git a/.claude/commands/backlog.md b/.claude/commands/backlog.md index 63f471c7..771271b9 100644 --- a/.claude/commands/backlog.md +++ b/.claude/commands/backlog.md @@ -3,14 +3,14 @@ description: 'Displays a consolidated backlog view from all sources (external tr allowed-tools: Read, Glob, Grep generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Backlog Viewer diff --git a/.claude/commands/brand.md b/.claude/commands/brand.md index c7f7a6ca..f7459536 100644 --- a/.claude/commands/brand.md +++ b/.claude/commands/brand.md @@ -3,14 +3,14 @@ description: 'Manage the project brand spec (brand.yaml) and editor theme. Suppo allowed-tools: Read, Glob, Grep, Write, Edit, Bash(npx agentkit *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # /brand — Brand Spec & Editor Theme Management diff --git a/.claude/commands/build.md b/.claude/commands/build.md index 7b37d5fb..fe92bec2 100644 --- a/.claude/commands/build.md +++ b/.claude/commands/build.md @@ -3,14 +3,14 @@ description: "Builds the project using the detected tech stack's build command. allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(go *), Bash(make *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Build diff --git a/.claude/commands/check.md b/.claude/commands/check.md index dcc55c16..64346728 100644 --- a/.claude/commands/check.md +++ b/.claude/commands/check.md @@ -3,14 +3,14 @@ description: 'Runs all quality checks for the repository: type checking, linting allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pip *), Bash(pytest *), Bash(go *), Bash(rustfmt *), Bash(prettier *), Bash(eslint *), Bash(ruff *), Bash(black *), Bash(mypy *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Universal Quality Gate diff --git a/.claude/commands/cost-centres.md b/.claude/commands/cost-centres.md index a619199c..70f36af4 100644 --- a/.claude/commands/cost-centres.md +++ b/.claude/commands/cost-centres.md @@ -3,14 +3,14 @@ description: 'Cost centre management for cloud infrastructure. Manages budget al allowed-tools: Read, Glob, Grep, Bash, Write, Edit generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # /cost-centres — Cost Centre Management diff --git a/.claude/commands/cost.md b/.claude/commands/cost.md index 835d291c..f44b8408 100644 --- a/.claude/commands/cost.md +++ b/.claude/commands/cost.md @@ -3,14 +3,14 @@ description: 'Session cost and usage tracking. Shows session summaries, lists re allowed-tools: Bash(node *), Read, Glob, Grep generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Cost & Usage Tracking @@ -49,6 +49,6 @@ You are the **Cost Tracker Agent**. You help users understand their AI session u ## Notes - Session tracking is automatic via lifecycle hooks (session-start, session-end). -- AgentKit tracks operational metrics (duration, commands, files) — not token counts. +- Retort tracks operational metrics (duration, commands, files) — not token counts. - Logs are stored in `.agentkit/logs/` as daily JSONL files. - Session records are in `.agentkit/logs/sessions/`. diff --git a/.claude/commands/deploy.md b/.claude/commands/deploy.md index 038d9f32..81b86d7d 100644 --- a/.claude/commands/deploy.md +++ b/.claude/commands/deploy.md @@ -3,14 +3,14 @@ description: 'Triggers a deployment pipeline or generates deployment artifacts. allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(docker *), Bash(kubectl *), Bash(az *), Bash(aws *), Bash(gcloud *), Bash(vercel *), Bash(netlify *), Bash(fly *), Bash(wrangler *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Deployment diff --git a/.claude/commands/discover.md b/.claude/commands/discover.md index c80f4d75..6a7fc514 100644 --- a/.claude/commands/discover.md +++ b/.claude/commands/discover.md @@ -6,14 +6,14 @@ description: 'Scans the repository to build a comprehensive understanding of the allowed-tools: Bash(git *), Bash(find *), Bash(ls *), Bash(cat *), Bash(head *), Bash(wc *), Bash(mkdir *), Bash(echo *), Bash(printf *), Bash(tee *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Codebase Discovery diff --git a/.claude/commands/doctor.md b/.claude/commands/doctor.md index 507dbfab..e0d451da 100644 --- a/.claude/commands/doctor.md +++ b/.claude/commands/doctor.md @@ -3,14 +3,14 @@ description: 'Runs AgentKit Forge diagnostics: spec validation, overlay sanity c allowed-tools: Bash(node *), Bash(find *), Bash(ls *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # /doctor @@ -18,7 +18,7 @@ Runs AgentKit Forge diagnostics: spec validation, overlay sanity checks, templat ## Purpose -Diagnose AgentKit Forge setup and spec quality issues quickly. +Diagnose Retort setup and spec quality issues quickly. ## Workflow diff --git a/.claude/commands/document-history.md b/.claude/commands/document-history.md index aa90e2b8..59bcc82a 100644 --- a/.claude/commands/document-history.md +++ b/.claude/commands/document-history.md @@ -3,14 +3,14 @@ description: 'Creates a structured history document from templates for significa allowed-tools: Read, Write, Edit, Glob, Grep, Bash(git *), Bash(./scripts/create-doc*), Bash(mkdir *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Document History diff --git a/.claude/commands/expand.md b/.claude/commands/expand.md index 7bf120a1..c611fd39 100644 --- a/.claude/commands/expand.md +++ b/.claude/commands/expand.md @@ -3,14 +3,14 @@ description: 'Runs the expansion analyzer to identify gaps, missing capabilities allowed-tools: Read, Write, Glob, Grep generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash-command definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - + - + # /expand — Expansion Analyzer @@ -63,6 +63,6 @@ Each suggestion includes: ## Project Context -- **Repository**: agentkit-forge +- **Repository**: retort - **Default Branch**: main - **Stack**: javascript, yaml, markdown diff --git a/.claude/commands/feature-configure.md b/.claude/commands/feature-configure.md index 891566c1..5ea710d6 100644 --- a/.claude/commands/feature-configure.md +++ b/.claude/commands/feature-configure.md @@ -3,14 +3,14 @@ description: 'Interactive feature configuration workflow. Walks through each fea allowed-tools: Bash(node *agentkit* features*) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Feature Configure @@ -18,7 +18,7 @@ You are the **Feature Operations Specialist**. You help the user configure kit f ## Context -This repository uses **AgentKit Forge** feature management with these presets: +This repository uses **Retort** feature management with these presets: | Preset | Features | Use-case | | -------- | -------- | ---------------------------------------------------- | diff --git a/.claude/commands/feature-flow.md b/.claude/commands/feature-flow.md index 6e26e442..4fd2d892 100644 --- a/.claude/commands/feature-flow.md +++ b/.claude/commands/feature-flow.md @@ -3,14 +3,14 @@ description: "Traces a specific feature end-to-end through the kit: shows which allowed-tools: '' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Feature Flow diff --git a/.claude/commands/feature-review.md b/.claude/commands/feature-review.md index 6502b486..0ab09085 100644 --- a/.claude/commands/feature-review.md +++ b/.claude/commands/feature-review.md @@ -3,14 +3,14 @@ description: 'Reviews the current feature configuration for the repo. Analyzes w allowed-tools: '' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Feature Review @@ -18,7 +18,7 @@ You are the **Feature Operations Specialist**. You review the current kit featur ## Context -This repository uses **AgentKit Forge** feature management. Features are defined in `.agentkit/spec/features.yaml` and controlled per-repo via the overlay settings at `.agentkit/overlays/*/settings.yaml`. +This repository uses **Retort** feature management. Features are defined in `.agentkit/spec/features.yaml` and controlled per-repo via the overlay settings at `.agentkit/overlays/*/settings.yaml`. ### Current Feature Configuration @@ -73,7 +73,7 @@ Based on `$ARGUMENTS`, perform one or more of these review modes: ## Output Format ```markdown -## Feature Review — agentkit-forge +## Feature Review — retort ### Configuration diff --git a/.claude/commands/format.md b/.claude/commands/format.md index d9548fdd..2cad9b8a 100644 --- a/.claude/commands/format.md +++ b/.claude/commands/format.md @@ -3,14 +3,14 @@ description: "Formats code using the detected tech stack's formatter. Can target allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pip *), Bash(prettier *), Bash(rustfmt *), Bash(black *), Bash(ruff *), Bash(gofmt *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Code Formatter diff --git a/.claude/commands/import-issues.md b/.claude/commands/import-issues.md index e43c954f..123d04f8 100644 --- a/.claude/commands/import-issues.md +++ b/.claude/commands/import-issues.md @@ -3,14 +3,14 @@ description: 'Imports issues from the configured external tracker (GitHub or Lin allowed-tools: Bash(gh *), Bash(linear *), Read, Write, Edit, Glob, Grep generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Import Issues diff --git a/.claude/commands/infra-eval.md b/.claude/commands/infra-eval.md index e1e47b55..7b438b1c 100644 --- a/.claude/commands/infra-eval.md +++ b/.claude/commands/infra-eval.md @@ -3,14 +3,14 @@ description: 'Risk-aware infrastructure and codebase evaluation against reliabil allowed-tools: Read, Glob, Grep, Bash, WebSearch, WebFetch generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # /infra-eval — Infrastructure & Codebase Fitness Evaluation diff --git a/.claude/commands/orchestrate.md b/.claude/commands/orchestrate.md index 1be739c1..58bb212c 100644 --- a/.claude/commands/orchestrate.md +++ b/.claude/commands/orchestrate.md @@ -3,14 +3,14 @@ description: 'Top-level orchestration command. Assesses the current repository s allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(dotnet *), Bash(cargo *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # W1 Orchestrator diff --git a/.claude/commands/plan.md b/.claude/commands/plan.md index ee9e13cc..5f8b9727 100644 --- a/.claude/commands/plan.md +++ b/.claude/commands/plan.md @@ -3,14 +3,14 @@ description: 'Creates a detailed implementation plan for a feature, bug fix, or allowed-tools: Bash(git *), Bash(find *), Bash(ls *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Implementation Plan diff --git a/.claude/commands/preflight.md b/.claude/commands/preflight.md index 01204a7e..deea88ff 100644 --- a/.claude/commands/preflight.md +++ b/.claude/commands/preflight.md @@ -3,14 +3,14 @@ description: 'Runs enhanced delivery checks before ship: quality gates, changelo allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pip *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # /preflight diff --git a/.claude/commands/project-status.md b/.claude/commands/project-status.md index 23baf8f0..f77bca9b 100644 --- a/.claude/commands/project-status.md +++ b/.claude/commands/project-status.md @@ -3,14 +3,14 @@ description: 'Unified PM dashboard that aggregates orchestrator state, backlog, allowed-tools: Read, Glob, Grep, Bash(git log*), Bash(gh issue list*) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # /project-status — Project Status Dashboard diff --git a/.claude/commands/review.md b/.claude/commands/review.md index dc68e96c..ffb485ae 100644 --- a/.claude/commands/review.md +++ b/.claude/commands/review.md @@ -3,7 +3,7 @@ description: 'Performs a structured code review of staged changes, a specific PR allowed-tools: Bash(git *), Bash(gh issue create*), Bash(gh issue list*), Bash(gh issue view*), Bash(linear *), Bash(mkdir *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- @@ -234,7 +234,7 @@ Use canonical lowercase severity values matching the issue template and task-pro ## Template & Generated-Format Issue Filing -When a finding targets a **generated file** (any file containing ` - - + + + # /scaffold diff --git a/.claude/commands/security.md b/.claude/commands/security.md index 8cd6acb5..a1c88dbe 100644 --- a/.claude/commands/security.md +++ b/.claude/commands/security.md @@ -3,14 +3,14 @@ description: 'Runs security-focused analysis: dependency vulnerability scanning, allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(pip *), Bash(pip-audit *), Bash(safety *), Bash(go *), Bash(govulncheck *), Bash(grep *), Bash(find *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Security Audit diff --git a/.claude/commands/start.md b/.claude/commands/start.md index eb505e10..aa4596a3 100644 --- a/.claude/commands/start.md +++ b/.claude/commands/start.md @@ -3,16 +3,16 @@ description: 'New user entry point. Detects repository state, shows contextual s allowed-tools: Read, Glob, Grep, AskUserQuestion, Bash(git *), Bash(find *), Bash(ls *), Bash(cat *), Bash(head *), Bash(test *), Bash(wc *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- -{{! GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT }} +{{! GENERATED by Retort v3.1.0 — DO NOT EDIT }} - - - + + + # Start — New User Entry Point @@ -34,7 +34,7 @@ You are the **Start Agent**. Your job is to orient users — especially new ones Gather these signals silently: -- **AgentKit Forge initialised?** — `.agentkit/` directory exists +- **Retort initialised?** — `.agentkit/` directory exists - **Sync has been run?** — `.claude/commands/orchestrate.md` exists - **Discovery completed?** — `AGENT_TEAMS.md` exists at repo root - **Orchestrator has prior state?** — `.claude/state/orchestrator.json` exists @@ -49,16 +49,16 @@ Gather these signals silently: Print a concise status table: -| Item | Status | -| -------------- | ----------------------------------- | -| AgentKit Forge | Initialised / Not initialised | -| Sync | Up to date / Needs sync / Never run | -| Discovery | Complete / Not run | -| Orchestrator | Phase N (name) / No prior session | -| Backlog | N items / Empty | -| Active tasks | N tasks / None | -| Branch | branch-name | -| Working tree | Clean / N uncommitted changes | +| Item | Status | +| ------------ | ----------------------------------- | +| Retort | Initialised / Not initialised | +| Sync | Up to date / Needs sync / Never run | +| Discovery | Complete / Not run | +| Orchestrator | Phase N (name) / No prior session | +| Backlog | N items / Empty | +| Active tasks | N tasks / None | +| Branch | branch-name | +| Working tree | Clean / N uncommitted changes | ## Phase 3: Guided Choices diff --git a/.claude/commands/sync-backlog.md b/.claude/commands/sync-backlog.md index 0cba6171..8c76d297 100644 --- a/.claude/commands/sync-backlog.md +++ b/.claude/commands/sync-backlog.md @@ -3,14 +3,14 @@ description: 'Synchronizes the local backlog with the configured issue tracker ( allowed-tools: Bash(git *), Bash(grep *), Bash(find *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Sync Backlog diff --git a/.claude/commands/sync.md b/.claude/commands/sync.md index 0c66bcb5..6812ece7 100644 --- a/.claude/commands/sync.md +++ b/.claude/commands/sync.md @@ -3,14 +3,14 @@ description: 'Regenerates all AI tool configurations from the AgentKit Forge spe allowed-tools: Bash(node *), Bash(pnpm *), Bash(git *), Read, Glob generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash-command definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - + - + # /sync — Regenerate AI Tool Configurations @@ -27,7 +27,7 @@ Regenerates all AI tool configurations from the AgentKit Forge spec. Renders tem Run from the repository root: ```bash -pnpm -C .agentkit agentkit:sync +pnpm -C .agentkit retort:sync ``` Or directly: @@ -54,7 +54,7 @@ node .agentkit/engines/node/src/cli.mjs sync ## When to Sync - After modifying any file in `.agentkit/spec/` -- After updating AgentKit Forge version +- After updating Retort version - After enabling or disabling features - When CI drift check fails @@ -66,5 +66,5 @@ node .agentkit/engines/node/src/cli.mjs sync ## Project Context -- **Repository**: agentkit-forge +- **Repository**: retort - **Default Branch**: main diff --git a/.claude/commands/team-backend.md b/.claude/commands/team-backend.md index 5834eeaf..5f7b9294 100644 --- a/.claude/commands/team-backend.md +++ b/.claude/commands/team-backend.md @@ -3,14 +3,14 @@ description: 'BACKEND (backend) — API, services, core logic' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # BACKEND diff --git a/.claude/commands/team-cost-ops.md b/.claude/commands/team-cost-ops.md index 66c6e820..c77b0a0f 100644 --- a/.claude/commands/team-cost-ops.md +++ b/.claude/commands/team-cost-ops.md @@ -3,14 +3,14 @@ description: 'COST OPS (cost-ops) — AI infrastructure cost reduction, vendor o allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # COST OPS diff --git a/.claude/commands/team-data.md b/.claude/commands/team-data.md index e2d6b001..e5535814 100644 --- a/.claude/commands/team-data.md +++ b/.claude/commands/team-data.md @@ -3,14 +3,14 @@ description: 'DATA (data) — Database, models, migrations' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # DATA diff --git a/.claude/commands/team-devops.md b/.claude/commands/team-devops.md index b5fc5afe..0f3fc1e2 100644 --- a/.claude/commands/team-devops.md +++ b/.claude/commands/team-devops.md @@ -3,14 +3,14 @@ description: 'DEVOPS (devops) — CI/CD, pipelines, automation' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # DEVOPS diff --git a/.claude/commands/team-docs.md b/.claude/commands/team-docs.md index 19b7e826..3fcc1dab 100644 --- a/.claude/commands/team-docs.md +++ b/.claude/commands/team-docs.md @@ -3,14 +3,14 @@ description: 'DOCUMENTATION (docs) — Docs, ADRs, guides' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # DOCUMENTATION diff --git a/.claude/commands/team-forge.md b/.claude/commands/team-forge.md index 17090594..654a44fb 100644 --- a/.claude/commands/team-forge.md +++ b/.claude/commands/team-forge.md @@ -3,14 +3,14 @@ description: 'TEAMFORGE (forge) — Meta-team — creates, validates, and deploy allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # TEAMFORGE diff --git a/.claude/commands/team-frontend.md b/.claude/commands/team-frontend.md index 4d7eece0..7d5606c9 100644 --- a/.claude/commands/team-frontend.md +++ b/.claude/commands/team-frontend.md @@ -3,14 +3,14 @@ description: 'FRONTEND (frontend) — UI, components, PWA' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # FRONTEND diff --git a/.claude/commands/team-infra.md b/.claude/commands/team-infra.md index 5258f3f1..898009cd 100644 --- a/.claude/commands/team-infra.md +++ b/.claude/commands/team-infra.md @@ -3,14 +3,14 @@ description: 'INFRA (infra) — IaC, cloud, Terraform/Bicep' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # INFRA diff --git a/.claude/commands/team-product.md b/.claude/commands/team-product.md index 954786c6..514990f0 100644 --- a/.claude/commands/team-product.md +++ b/.claude/commands/team-product.md @@ -3,14 +3,14 @@ description: 'PRODUCT (product) — Features, PRDs, roadmap' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # PRODUCT diff --git a/.claude/commands/team-quality.md b/.claude/commands/team-quality.md index fe310ac0..234490fd 100644 --- a/.claude/commands/team-quality.md +++ b/.claude/commands/team-quality.md @@ -3,14 +3,14 @@ description: 'QUALITY (quality) — Code review, refactoring, bugs, reliability, allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # QUALITY diff --git a/.claude/commands/team-security.md b/.claude/commands/team-security.md index dd70bcd6..f23aa68c 100644 --- a/.claude/commands/team-security.md +++ b/.claude/commands/team-security.md @@ -3,14 +3,14 @@ description: 'SECURITY (security) — Auth, compliance, audit' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # SECURITY diff --git a/.claude/commands/team-strategic-ops.md b/.claude/commands/team-strategic-ops.md index a79e4929..4b9cc561 100644 --- a/.claude/commands/team-strategic-ops.md +++ b/.claude/commands/team-strategic-ops.md @@ -3,14 +3,14 @@ description: 'STRATEGIC OPS (strategic-ops) — Cross-project coordination, fram allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # STRATEGIC OPS diff --git a/.claude/commands/team-testing.md b/.claude/commands/team-testing.md index 24da640b..8c78bf4e 100644 --- a/.claude/commands/team-testing.md +++ b/.claude/commands/team-testing.md @@ -3,14 +3,14 @@ description: 'TESTING (testing) — Unit, E2E, integration tests' allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # TESTING diff --git a/.claude/commands/test.md b/.claude/commands/test.md index e3cc180f..8698a5a4 100644 --- a/.claude/commands/test.md +++ b/.claude/commands/test.md @@ -3,14 +3,14 @@ description: "Runs the test suite using the detected tech stack's test command. allowed-tools: Bash(git *), Bash(npm *), Bash(pnpm *), Bash(npx *), Bash(dotnet *), Bash(cargo *), Bash(python *), Bash(pytest *), Bash(go *), Bash(vitest *), Bash(jest *) generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash command. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory#slash-commands --- - - - + + + # Test Runner diff --git a/.claude/commands/validate.md b/.claude/commands/validate.md index 43ede8df..c0fb83fc 100644 --- a/.claude/commands/validate.md +++ b/.claude/commands/validate.md @@ -3,14 +3,14 @@ description: 'Validates generated outputs for correctness. Checks that all requi allowed-tools: Read, Glob generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude slash-command definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - + - + # /validate — Output Validator @@ -49,5 +49,5 @@ Overall status: **PASS** (all checks green) or **FAIL** (one or more checks fail ## Project Context -- **Repository**: agentkit-forge +- **Repository**: retort - **Default Branch**: main diff --git a/.claude/hooks/budget-guard-check.sh b/.claude/hooks/budget-guard-check.sh index 1ba0de36..7d06dd95 100755 --- a/.claude/hooks/budget-guard-check.sh +++ b/.claude/hooks/budget-guard-check.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Bash|Write|Edit) # Purpose: Check session and daily budgets before allowing tool execution. diff --git a/.claude/hooks/guard-destructive-commands.ps1 b/.claude/hooks/guard-destructive-commands.ps1 index b4d0b08c..06a3aa16 100644 --- a/.claude/hooks/guard-destructive-commands.ps1 +++ b/.claude/hooks/guard-destructive-commands.ps1 @@ -1,7 +1,7 @@ #!/usr/bin/env pwsh # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Bash) # Purpose: Block destructive shell commands before they execute. diff --git a/.claude/hooks/guard-destructive-commands.sh b/.claude/hooks/guard-destructive-commands.sh index 0a403769..df759ea6 100755 --- a/.claude/hooks/guard-destructive-commands.sh +++ b/.claude/hooks/guard-destructive-commands.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Bash) # Purpose: Block destructive shell commands before they execute. diff --git a/.claude/hooks/pre-push-validate.sh b/.claude/hooks/pre-push-validate.sh index a372540e..67a8e73f 100755 --- a/.claude/hooks/pre-push-validate.sh +++ b/.claude/hooks/pre-push-validate.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Bash) # Purpose: Before a git push, validate: diff --git a/.claude/hooks/protect-sensitive.ps1 b/.claude/hooks/protect-sensitive.ps1 index c498012f..b667beb4 100644 --- a/.claude/hooks/protect-sensitive.ps1 +++ b/.claude/hooks/protect-sensitive.ps1 @@ -1,7 +1,7 @@ #!/usr/bin/env pwsh # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Write|Edit) # Purpose: Block writes to sensitive files such as .env, secrets, keys, etc. diff --git a/.claude/hooks/protect-sensitive.sh b/.claude/hooks/protect-sensitive.sh index 08900f08..1bb883b2 100755 --- a/.claude/hooks/protect-sensitive.sh +++ b/.claude/hooks/protect-sensitive.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Write|Edit) # Purpose: Block writes to sensitive files such as .env, secrets, keys, etc. diff --git a/.claude/hooks/protect-templates.ps1 b/.claude/hooks/protect-templates.ps1 index 541637fa..93df8585 100644 --- a/.claude/hooks/protect-templates.ps1 +++ b/.claude/hooks/protect-templates.ps1 @@ -1,9 +1,9 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Write|Edit) -# Purpose: Block AI writes to AgentKit Forge source files (templates, spec, +# Purpose: Block AI writes to Retort source files (templates, spec, # engines, overlays) in DOWNSTREAM repos. In the agentkit-forge source # repo itself, agents ARE the maintainers and need full access. # Stdin: JSON with session_id, cwd, hook_event_name, tool_name, tool_input @@ -55,7 +55,7 @@ $protectedPatterns = @( foreach ($pattern in $protectedPatterns) { if ($filePath -match $pattern) { - $reason = "Blocked: '$filePath' is an AgentKit Forge source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run 'pnpm -C .agentkit agentkit:sync'." + $reason = "Blocked: '$filePath' is a Retort source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run 'pnpm -C .agentkit retort:sync'." @{ hookSpecificOutput = @{ hookEventName = 'PreToolUse' diff --git a/.claude/hooks/protect-templates.sh b/.claude/hooks/protect-templates.sh index 4715d3fb..3926a3d1 100755 --- a/.claude/hooks/protect-templates.sh +++ b/.claude/hooks/protect-templates.sh @@ -1,10 +1,10 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PreToolUse (matcher: Write|Edit) -# Purpose: Block AI writes to AgentKit Forge source files (templates, spec, +# Purpose: Block AI writes to Retort source files (templates, spec, # engines, overlays) in DOWNSTREAM repos. In the agentkit-forge source # repo itself, agents ARE the maintainers and need full access. # Stdin: JSON with session_id, cwd, hook_event_name, tool_name, tool_input @@ -50,7 +50,7 @@ PROTECTED_PATTERNS=( for pattern in "${PROTECTED_PATTERNS[@]}"; do if echo "$FILE_PATH" | grep -qE "$pattern"; then jq -n \ - --arg reason "Blocked: '${FILE_PATH}' is an AgentKit Forge source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run 'pnpm -C .agentkit agentkit:sync'." \ + --arg reason "Blocked: '${FILE_PATH}' is a Retort source file. These files are the upstream source-of-truth and must not be modified directly by AI agents. To propose changes, create a PR to the agentkit-forge repository targeting the relevant spec or template. If you need to change project configuration, edit the YAML specs in .agentkit/spec/ and run 'pnpm -C .agentkit retort:sync'." \ '{ hookSpecificOutput: { hookEventName: "PreToolUse", diff --git a/.claude/hooks/session-start.ps1 b/.claude/hooks/session-start.ps1 index 3277e02c..12549901 100644 --- a/.claude/hooks/session-start.ps1 +++ b/.claude/hooks/session-start.ps1 @@ -1,7 +1,7 @@ #!/usr/bin/env pwsh # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: SessionStart # Purpose: Detect installed tooling, show git status, and return environment diff --git a/.claude/hooks/session-start.sh b/.claude/hooks/session-start.sh index 27ccfd22..db82883b 100755 --- a/.claude/hooks/session-start.sh +++ b/.claude/hooks/session-start.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: SessionStart # Purpose: Detect installed tooling, show git status, and return environment diff --git a/.claude/hooks/stop-build-check.ps1 b/.claude/hooks/stop-build-check.ps1 index 2bb66788..96602db6 100644 --- a/.claude/hooks/stop-build-check.ps1 +++ b/.claude/hooks/stop-build-check.ps1 @@ -1,7 +1,7 @@ #!/usr/bin/env pwsh # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: Stop # Purpose: Best-effort build / lint / test validation before Claude stops. diff --git a/.claude/hooks/stop-build-check.sh b/.claude/hooks/stop-build-check.sh index 71cb7955..59d93077 100755 --- a/.claude/hooks/stop-build-check.sh +++ b/.claude/hooks/stop-build-check.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: Stop # Purpose: Best-effort build / lint / test validation before Claude stops. diff --git a/.claude/hooks/warn-uncommitted.ps1 b/.claude/hooks/warn-uncommitted.ps1 index f4ac6f0f..3ba51634 100644 --- a/.claude/hooks/warn-uncommitted.ps1 +++ b/.claude/hooks/warn-uncommitted.ps1 @@ -1,7 +1,7 @@ #!/usr/bin/env pwsh # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PostToolUse (matcher: Write|Edit) # Purpose: Warn when the number of uncommitted changes grows too large. diff --git a/.claude/hooks/warn-uncommitted.sh b/.claude/hooks/warn-uncommitted.sh index 8555f547..03004e85 100755 --- a/.claude/hooks/warn-uncommitted.sh +++ b/.claude/hooks/warn-uncommitted.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # Hook: PostToolUse (matcher: Write|Edit) # Purpose: Warn when the number of uncommitted changes grows too large. diff --git a/.claude/rules/agent-conduct.md b/.claude/rules/agent-conduct.md index 8efc5110..96dea601 100644 --- a/.claude/rules/agent-conduct.md +++ b/.claude/rules/agent-conduct.md @@ -1,7 +1,7 @@ - + - - + + @@ -50,5 +50,5 @@ Applies across all AI coding tools (Claude, Cursor, Copilot, Windsurf, Cline, et ## Generated Files -- **Never** edit files with `` -- Modify upstream spec in `.agentkit/spec/` and run `agentkit sync` instead +- **Never** edit files with `` +- Modify upstream spec in `.agentkit/spec/` and run `retort sync` instead diff --git a/.claude/rules/blockchain.md b/.claude/rules/blockchain.md index 29e35202..32ed5872 100644 --- a/.claude/rules/blockchain.md +++ b/.claude/rules/blockchain.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/ci-cd.md b/.claude/rules/ci-cd.md index 8aba256e..4e036d08 100644 --- a/.claude/rules/ci-cd.md +++ b/.claude/rules/ci-cd.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/dependency-management.md b/.claude/rules/dependency-management.md index 82dae17a..d99da1b4 100644 --- a/.claude/rules/dependency-management.md +++ b/.claude/rules/dependency-management.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/documentation.md b/.claude/rules/documentation.md index e4fb451d..044308b6 100644 --- a/.claude/rules/documentation.md +++ b/.claude/rules/documentation.md @@ -1,7 +1,7 @@ - + - - + + @@ -31,8 +31,8 @@ All documentation lives in `docs/` under these categories: ## Generated Files -- Files with `` are sync output -- **Never** edit them directly — modify `.agentkit/spec/` and run `agentkit sync` +- Files with `` are sync output +- **Never** edit them directly — modify `.agentkit/spec/` and run `retort sync` - CI drift check will fail if generated output is out of sync with spec ## Changelog diff --git a/.claude/rules/dotnet.md b/.claude/rules/dotnet.md index 5f693894..3ba31a56 100644 --- a/.claude/rules/dotnet.md +++ b/.claude/rules/dotnet.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/git-workflow.md b/.claude/rules/git-workflow.md index 35c97cca..173bb8ac 100644 --- a/.claude/rules/git-workflow.md +++ b/.claude/rules/git-workflow.md @@ -1,7 +1,7 @@ - + - - + + @@ -35,8 +35,8 @@ These rules govern branching, committing, pull requests, and merge strategy. ## Generated Files -- Files with the header `GENERATED by AgentKit Forge — DO NOT EDIT` are sync outputs -- **Never edit generated files directly** — modify `.agentkit/spec/*.yaml` then run `pnpm -C .agentkit agentkit:sync` +- Files with the header `GENERATED by Retort — DO NOT EDIT` are sync outputs +- **Never edit generated files directly** — modify `.agentkit/spec/*.yaml` then run `pnpm -C .agentkit retort:sync` - After running sync, commit both the spec change and the regenerated outputs - CI runs a drift check — if generated files are out of sync the build will fail diff --git a/.claude/rules/iac.md b/.claude/rules/iac.md index 67aab85a..dfe73eaa 100644 --- a/.claude/rules/iac.md +++ b/.claude/rules/iac.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/languages/README.md b/.claude/rules/languages/README.md index afe5855e..531f558b 100644 --- a/.claude/rules/languages/README.md +++ b/.claude/rules/languages/README.md @@ -1,7 +1,7 @@ - - - - + + + + # Language-Specific Instructions @@ -10,7 +10,7 @@ This directory contains instruction files for **agentkit-forge**, one per rule domain defined in `.agentkit/spec/rules.yaml`. Each file provides language-specific coding conventions, testing patterns, and tooling requirements. -These files are generated by AgentKit Forge and deployed to each configured AI +These files are generated by Retort and deployed to each configured AI platform: | Platform | Output location | @@ -29,7 +29,7 @@ platform: ## How It Works -For each rule domain, AgentKit Forge renders a Markdown file using the +For each rule domain, Retort renders a Markdown file using the following template priority: 1. **Platform overlay** — `/language-instructions/.md` diff --git a/.claude/rules/languages/agent-conduct.md b/.claude/rules/languages/agent-conduct.md index dbc10857..09749ba5 100644 --- a/.claude/rules/languages/agent-conduct.md +++ b/.claude/rules/languages/agent-conduct.md @@ -1,4 +1,4 @@ - + # Instructions — agent-conduct diff --git a/.claude/rules/languages/ai-cost-ops.md b/.claude/rules/languages/ai-cost-ops.md index d924c4f4..29bc2a3d 100644 --- a/.claude/rules/languages/ai-cost-ops.md +++ b/.claude/rules/languages/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ai-cost-ops diff --git a/.claude/rules/languages/blockchain.md b/.claude/rules/languages/blockchain.md index 033a47be..6dbf76e3 100644 --- a/.claude/rules/languages/blockchain.md +++ b/.claude/rules/languages/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Blockchain / Smart Contracts diff --git a/.claude/rules/languages/ci-cd.md b/.claude/rules/languages/ci-cd.md index 501f6b92..5a51259d 100644 --- a/.claude/rules/languages/ci-cd.md +++ b/.claude/rules/languages/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ci-cd diff --git a/.claude/rules/languages/dependency-management.md b/.claude/rules/languages/dependency-management.md index 3447a4f0..a1e223e8 100644 --- a/.claude/rules/languages/dependency-management.md +++ b/.claude/rules/languages/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — dependency-management diff --git a/.claude/rules/languages/documentation.md b/.claude/rules/languages/documentation.md index 1f17dee9..ad2b59cc 100644 --- a/.claude/rules/languages/documentation.md +++ b/.claude/rules/languages/documentation.md @@ -1,4 +1,4 @@ - + # Instructions — documentation diff --git a/.claude/rules/languages/dotnet.md b/.claude/rules/languages/dotnet.md index 28cdeb94..a0b143fa 100644 --- a/.claude/rules/languages/dotnet.md +++ b/.claude/rules/languages/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — .NET / C# diff --git a/.claude/rules/languages/finops.md b/.claude/rules/languages/finops.md index caeb856c..34e716e2 100644 --- a/.claude/rules/languages/finops.md +++ b/.claude/rules/languages/finops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — finops diff --git a/.claude/rules/languages/git-workflow.md b/.claude/rules/languages/git-workflow.md index c0ffc0ff..188f6636 100644 --- a/.claude/rules/languages/git-workflow.md +++ b/.claude/rules/languages/git-workflow.md @@ -1,4 +1,4 @@ - + # Instructions — git-workflow diff --git a/.claude/rules/languages/iac.md b/.claude/rules/languages/iac.md index 9a60811c..4d5275be 100644 --- a/.claude/rules/languages/iac.md +++ b/.claude/rules/languages/iac.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Infrastructure as Code diff --git a/.claude/rules/languages/python.md b/.claude/rules/languages/python.md index 4b32df79..e306fb2d 100644 --- a/.claude/rules/languages/python.md +++ b/.claude/rules/languages/python.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Python diff --git a/.claude/rules/languages/rust.md b/.claude/rules/languages/rust.md index 449fe7d0..5bce7d63 100644 --- a/.claude/rules/languages/rust.md +++ b/.claude/rules/languages/rust.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Rust diff --git a/.claude/rules/languages/security.md b/.claude/rules/languages/security.md index 9f21e175..17c37314 100644 --- a/.claude/rules/languages/security.md +++ b/.claude/rules/languages/security.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — security diff --git a/.claude/rules/languages/template-protection.md b/.claude/rules/languages/template-protection.md index f7acfee9..78f276ce 100644 --- a/.claude/rules/languages/template-protection.md +++ b/.claude/rules/languages/template-protection.md @@ -1,4 +1,4 @@ - + # Instructions — template-protection diff --git a/.claude/rules/languages/testing.md b/.claude/rules/languages/testing.md index 64fe69b3..585420e0 100644 --- a/.claude/rules/languages/testing.md +++ b/.claude/rules/languages/testing.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — testing diff --git a/.claude/rules/languages/typescript.md b/.claude/rules/languages/typescript.md index feba3f0b..71a6101e 100644 --- a/.claude/rules/languages/typescript.md +++ b/.claude/rules/languages/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — TypeScript / JavaScript diff --git a/.claude/rules/pr-base-branch.md b/.claude/rules/pr-base-branch.md new file mode 100644 index 00000000..0d895fea --- /dev/null +++ b/.claude/rules/pr-base-branch.md @@ -0,0 +1,50 @@ + + + + + + +# PR Base Branch Guard + +Always use `--base dev` when creating pull requests in **retort**. + +## Rule + +**Event**: bash +**Action**: warn +**Pattern**: `gh pr create` without `--base dev` + +## Why This Matters + +This repository uses a two-branch model: + +- `main` — production branch, never targeted directly by feature PRs +- `dev` — integration branch, the correct PR target for all feature work + +Creating PRs against `main` instead of `dev` triggers an automatic reverse-merge PR (merging `main` back into `dev`), which creates noise and bypasses the integration pipeline. + +## Correct Usage + +```bash +# Always specify --base explicitly +gh pr create --base dev --title "type(scope): description" +``` + +## Incorrect Usage + +```bash +# These will target the wrong branch +gh pr create --title "type(scope): description" +gh pr create --base main --title "type(scope): description" +``` + +## Configuration + +The integration branch is configured in `.agentkit/overlays/retort/settings.yaml`: + +```yaml +defaultBranch: main +integrationBranch: dev +``` + +To change the integration branch, update `settings.yaml` and run `pnpm -C .agentkit retort:sync`. diff --git a/.claude/rules/python.md b/.claude/rules/python.md index ba88f907..307b36dd 100644 --- a/.claude/rules/python.md +++ b/.claude/rules/python.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/quality.md b/.claude/rules/quality.md index 7fd46332..2a35ee2a 100644 --- a/.claude/rules/quality.md +++ b/.claude/rules/quality.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/rust.md b/.claude/rules/rust.md index 94b8ca3b..36fa05e2 100644 --- a/.claude/rules/rust.md +++ b/.claude/rules/rust.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/security.md b/.claude/rules/security.md index b1971890..00bd70d5 100644 --- a/.claude/rules/security.md +++ b/.claude/rules/security.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/template-protection.md b/.claude/rules/template-protection.md index 515f4693..aba756b2 100644 --- a/.claude/rules/template-protection.md +++ b/.claude/rules/template-protection.md @@ -1,7 +1,7 @@ - + - - + + @@ -9,8 +9,8 @@ ## Source-of-Truth Directories -The following directories are the **upstream source-of-truth** for AgentKit Forge. -They generate all AI tool configurations via `agentkit sync`. **AI agents MUST NOT +The following directories are the **upstream source-of-truth** for Retort. +They generate all AI tool configurations via `retort sync`. **AI agents MUST NOT modify these files directly.** | Directory | Purpose | @@ -26,10 +26,10 @@ modify these files directly.** When you need to change AI tool behavior, generated rules, commands, or team definitions: 1. **Do NOT edit files in `.agentkit/templates/`, `.agentkit/engines/`, `.agentkit/overlays/`, or `.agentkit/bin/`** — they are protected by a PreToolUse hook -2. **Do NOT edit generated files** marked `` +2. **Do NOT edit generated files** marked `` 3. **Instead**, describe the desired change and recommend the user: - Modify the relevant YAML spec in `.agentkit/spec/` (this is the intended edit point) - - Run `pnpm -C .agentkit agentkit:sync` to regenerate + - Run `pnpm -C .agentkit retort:sync` to regenerate - Or create a PR to the agentkit-forge repository for template/engine changes ## What You CAN Modify @@ -41,7 +41,7 @@ When you need to change AI tool behavior, generated rules, commands, or team def ## Rationale -AgentKit Forge follows a **spec-driven architecture**: YAML specs are the single source +Retort follows a **spec-driven architecture**: YAML specs are the single source of truth, templates transform specs into tool-specific configs, and the sync engine renders the output. Direct edits to templates or specs by AI agents would: diff --git a/.claude/rules/testing.md b/.claude/rules/testing.md index 21b4c080..f5767b02 100644 --- a/.claude/rules/testing.md +++ b/.claude/rules/testing.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/rules/typescript.md b/.claude/rules/typescript.md index ccd6e80a..6dd77ab2 100644 --- a/.claude/rules/typescript.md +++ b/.claude/rules/typescript.md @@ -1,7 +1,7 @@ - + - - + + diff --git a/.claude/skills/analyze-agents/SKILL.md b/.claude/skills/analyze-agents/SKILL.md index 21120285..7dd30044 100644 --- a/.claude/skills/analyze-agents/SKILL.md +++ b/.claude/skills/analyze-agents/SKILL.md @@ -3,14 +3,14 @@ name: 'analyze-agents' description: 'Generates a comprehensive agent/team relationship matrix. Analyzes dependencies, notifications, handoffs, coverage gaps, bottlenecks, and consolidation opportunities across all teams and agents.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # analyze-agents @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `analyze-agents` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/backlog/SKILL.md b/.claude/skills/backlog/SKILL.md index 2c8772ce..2e6f096c 100644 --- a/.claude/skills/backlog/SKILL.md +++ b/.claude/skills/backlog/SKILL.md @@ -3,14 +3,14 @@ name: 'backlog' description: 'Displays a consolidated backlog view from all sources (external tracker, discovery, healthcheck, code TODOs, review findings, manual entries). Supports filtering and multiple output formats for CLI and future UI consumption.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # backlog @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `backlog` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/brand/SKILL.md b/.claude/skills/brand/SKILL.md index c6c36792..3c9eaa0a 100644 --- a/.claude/skills/brand/SKILL.md +++ b/.claude/skills/brand/SKILL.md @@ -3,14 +3,14 @@ name: 'brand' description: 'Manage the project brand spec (brand.yaml) and editor theme. Supports validation, palette preview, theme mapping, contrast auditing, scaffolding, and regeneration of editor theme files.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # brand @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `brand` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/build/SKILL.md b/.claude/skills/build/SKILL.md index 05d4b945..11e93cb4 100644 --- a/.claude/skills/build/SKILL.md +++ b/.claude/skills/build/SKILL.md @@ -3,14 +3,14 @@ name: 'build' description: 'Builds the project using the detected tech stack's build command. Supports targeting specific packages in a monorepo or building the entire workspace.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # build @@ -59,7 +59,7 @@ Report: detected stack, scope, exact command, status (PASS/FAIL), duration, arti ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/check/SKILL.md b/.claude/skills/check/SKILL.md index 8f3a9836..60336754 100644 --- a/.claude/skills/check/SKILL.md +++ b/.claude/skills/check/SKILL.md @@ -3,14 +3,14 @@ name: 'check' description: 'Runs all quality checks for the repository: type checking, linting, formatting validation, and test suites. Returns a unified pass/fail status with detailed breakdowns per check category.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # check @@ -51,7 +51,7 @@ Produce: Quality Gate Results table (Step | Status | Duration | Details), Overal ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/cost-centres/SKILL.md b/.claude/skills/cost-centres/SKILL.md index d745f499..b1f6d8d6 100644 --- a/.claude/skills/cost-centres/SKILL.md +++ b/.claude/skills/cost-centres/SKILL.md @@ -3,14 +3,14 @@ name: 'cost-centres' description: 'Cost centre management for cloud infrastructure. Manages budget allocations, resource group mappings, tag compliance, and spend tracking. Requires a FinOps-enabled overlay (finops rule domain). For AI session cost tracking, use /cost instead.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # cost-centres @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `cost-centres` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/cost/SKILL.md b/.claude/skills/cost/SKILL.md index 1fa04eb4..0ffb79a4 100644 --- a/.claude/skills/cost/SKILL.md +++ b/.claude/skills/cost/SKILL.md @@ -3,14 +3,14 @@ name: 'cost' description: 'Session cost and usage tracking. Shows session summaries, lists recent sessions, and generates aggregate usage reports. Tracks session duration, commands run, and files modified via lifecycle hooks.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # cost @@ -44,7 +44,7 @@ Invoke this skill when you need to perform the `cost` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/deploy/SKILL.md b/.claude/skills/deploy/SKILL.md index 1ea6e870..cbef7b9c 100644 --- a/.claude/skills/deploy/SKILL.md +++ b/.claude/skills/deploy/SKILL.md @@ -3,14 +3,14 @@ name: 'deploy' description: 'Triggers a deployment pipeline or generates deployment artifacts. Validates pre-deployment checks (build, test, lint) before proceeding. Supports dry-run mode for safety.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # deploy @@ -65,7 +65,7 @@ Report: service, environment, platform, status, timeline, command output, post-d ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/discover/SKILL.md b/.claude/skills/discover/SKILL.md index 3a4c5c0d..9a53d499 100644 --- a/.claude/skills/discover/SKILL.md +++ b/.claude/skills/discover/SKILL.md @@ -3,14 +3,14 @@ name: 'discover' description: 'Scans the repository to build a comprehensive understanding of the project structure, tech stacks in use, team boundaries, and architectural patterns. Outputs a structured discovery report used by other commands.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # discover @@ -47,7 +47,7 @@ Create or update `AGENT_TEAMS.md` with: Repository Profile (primary stack, build ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/doctor/SKILL.md b/.claude/skills/doctor/SKILL.md index ce472354..a245940b 100644 --- a/.claude/skills/doctor/SKILL.md +++ b/.claude/skills/doctor/SKILL.md @@ -3,14 +3,14 @@ name: 'doctor' description: 'Runs AgentKit Forge diagnostics: spec validation, overlay sanity checks, template availability, project.yaml completeness hints, and suggested next actions for fixing setup issues.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # doctor @@ -36,7 +36,7 @@ Invoke this skill when you need to perform the `doctor` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/document-history/SKILL.md b/.claude/skills/document-history/SKILL.md index 33dc5c4a..adcf34f3 100644 --- a/.claude/skills/document-history/SKILL.md +++ b/.claude/skills/document-history/SKILL.md @@ -3,14 +3,14 @@ name: 'document-history' description: 'Creates a structured history document from templates for significant work completed in the current session. Supports bug fixes, features, implementations, and migrations. Auto-detects type and title from git history when invoked without arguments. Fills in all template sections with concrete details from session context.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # document-history @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `document-history` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/expand/SKILL.md b/.claude/skills/expand/SKILL.md index 56245143..48877ba1 100644 --- a/.claude/skills/expand/SKILL.md +++ b/.claude/skills/expand/SKILL.md @@ -3,14 +3,14 @@ name: 'expand' description: 'Runs the expansion analyzer to identify gaps, missing capabilities, undocumented decisions, and improvement opportunities in the codebase. Produces a ranked list of suggestions with rationale, impact scores, and effort estimates. Never creates tasks in analysis mode — all suggestions require explicit human approval. Use --save to persist suggestions to disk for later review.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # expand @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `expand` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/feature-configure/SKILL.md b/.claude/skills/feature-configure/SKILL.md index c14359e0..40ab8bb3 100644 --- a/.claude/skills/feature-configure/SKILL.md +++ b/.claude/skills/feature-configure/SKILL.md @@ -3,14 +3,14 @@ name: 'feature-configure' description: 'Interactive feature configuration workflow. Walks through each feature category, explains what each feature provides, shows current status, and applies changes via the overlay settings.yaml. Triggers a sync after changes are applied.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # feature-configure @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `feature-configure` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/feature-flow/SKILL.md b/.claude/skills/feature-flow/SKILL.md index 96467b9f..07160af0 100644 --- a/.claude/skills/feature-flow/SKILL.md +++ b/.claude/skills/feature-flow/SKILL.md @@ -3,14 +3,14 @@ name: 'feature-flow' description: 'Traces a specific feature end-to-end through the kit: shows which spec files define it, which template vars it injects, which templates consume those vars, what generated output it produces, and what overlay settings control it. Use this to understand or debug a feature's behavior.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # feature-flow @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `feature-flow` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/feature-review/SKILL.md b/.claude/skills/feature-review/SKILL.md index 62144c2d..759804b7 100644 --- a/.claude/skills/feature-review/SKILL.md +++ b/.claude/skills/feature-review/SKILL.md @@ -3,14 +3,14 @@ name: 'feature-review' description: 'Reviews the current feature configuration for the repo. Analyzes which features are enabled/disabled, checks for misconfigured dependencies, identifies unused features (enabled but no matching code patterns), and recommends features to enable based on codebase analysis.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # feature-review @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `feature-review` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/format/SKILL.md b/.claude/skills/format/SKILL.md index 5838d898..58a6e6aa 100644 --- a/.claude/skills/format/SKILL.md +++ b/.claude/skills/format/SKILL.md @@ -3,14 +3,14 @@ name: 'format' description: 'Formats code using the detected tech stack's formatter. Can target specific files, directories, or the entire workspace. Reports files that were changed.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # format @@ -56,7 +56,7 @@ Report: formatters run, scope, mode, files changed/needing formatting, summary c ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/import-issues/SKILL.md b/.claude/skills/import-issues/SKILL.md index e5e598e4..1c1c1e03 100644 --- a/.claude/skills/import-issues/SKILL.md +++ b/.claude/skills/import-issues/SKILL.md @@ -3,14 +3,14 @@ name: 'import-issues' description: 'Imports issues from the configured external tracker (GitHub or Linear), normalizes fields to the canonical backlog schema, deduplicates against existing items, assigns teams via intake routing rules, and merges into AGENT_BACKLOG.md and .claude/state/backlog.json. Gated behind the process.intake.autoImport flag (can be overridden with --force).' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # import-issues @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `import-issues` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/infra-eval/SKILL.md b/.claude/skills/infra-eval/SKILL.md index 82c5646b..6be0fd17 100644 --- a/.claude/skills/infra-eval/SKILL.md +++ b/.claude/skills/infra-eval/SKILL.md @@ -3,14 +3,14 @@ name: 'infra-eval' description: 'Risk-aware infrastructure and codebase evaluation against reliability, cost, and scale fitness. Scores eight weighted dimensions (0–5 each), enforces hard gates for critical safety properties, and produces a scored summary with narrative risk analysis. Designed for quarterly reassessment, pre-funding due diligence, and architectural decision support. Gated behind the evaluation.infraEval project.yaml flag.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # infra-eval @@ -30,7 +30,7 @@ Invoke this skill when you need to perform the `infra-eval` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/orchestrate/SKILL.md b/.claude/skills/orchestrate/SKILL.md index 3b00c646..ad25d799 100644 --- a/.claude/skills/orchestrate/SKILL.md +++ b/.claude/skills/orchestrate/SKILL.md @@ -3,14 +3,14 @@ name: 'orchestrate' description: 'Top-level orchestration command. Assesses the current repository state, identifies work to be done, delegates to appropriate team agents, and synthesizes results. The primary entry point for multi-step workflows.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # orchestrate @@ -55,7 +55,7 @@ Produce a summary with: Actions Taken, Files Changed, Validation Commands, Updat ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/plan/SKILL.md b/.claude/skills/plan/SKILL.md index 9e229482..062733cb 100644 --- a/.claude/skills/plan/SKILL.md +++ b/.claude/skills/plan/SKILL.md @@ -3,14 +3,14 @@ name: 'plan' description: 'Creates a detailed implementation plan for a feature, bug fix, or refactoring task. Analyzes the codebase, identifies affected files and teams, estimates complexity, and produces a step-by-step plan with acceptance criteria.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # plan @@ -45,7 +45,7 @@ You are the **Planning Agent**. Produce detailed, structured implementation plan ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/preflight/SKILL.md b/.claude/skills/preflight/SKILL.md index fc31e290..8b4e4d9e 100644 --- a/.claude/skills/preflight/SKILL.md +++ b/.claude/skills/preflight/SKILL.md @@ -3,14 +3,14 @@ name: 'preflight' description: 'Runs enhanced delivery checks before ship: quality gates, changelog, coverage delta, commit convention conformance, TODO/FIXME hygiene, and documentation updates for externally visible changes.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # preflight @@ -41,7 +41,7 @@ If `--range` is omitted, auto-detect via merge-base against the default branch. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/project-status/SKILL.md b/.claude/skills/project-status/SKILL.md index 3c7c273b..d0a8b85f 100644 --- a/.claude/skills/project-status/SKILL.md +++ b/.claude/skills/project-status/SKILL.md @@ -3,14 +3,14 @@ name: 'project-status' description: 'Unified PM dashboard that aggregates orchestrator state, backlog, task progress, risks, and delivery metrics into a markdown or JSON report. Provides at-a-glance visibility into project health across all teams.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # project-status @@ -120,7 +120,7 @@ Produce markdown (default) or JSON (with `--format json`) with these sections: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/review/SKILL.md b/.claude/skills/review/SKILL.md index 34a1686f..120edf91 100644 --- a/.claude/skills/review/SKILL.md +++ b/.claude/skills/review/SKILL.md @@ -3,14 +3,14 @@ name: 'review' description: 'Performs a structured code review of staged changes, a specific PR, or a range of commits. Evaluates code quality, adherence to domain rules, security concerns, test coverage, and architectural alignment.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # review @@ -63,7 +63,7 @@ Produce: Summary, Required Changes (must fix, with file:line references), Sugges ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/scaffold/SKILL.md b/.claude/skills/scaffold/SKILL.md index 81ceea2a..2e17f72d 100644 --- a/.claude/skills/scaffold/SKILL.md +++ b/.claude/skills/scaffold/SKILL.md @@ -3,14 +3,14 @@ name: 'scaffold' description: 'Generates implementation skeletons aligned with project conventions. Supports endpoints, UI components, IaC modules, migrations, tests, and services. Uses project.yaml context and domain rules to prefill structure and guardrails.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # scaffold @@ -41,7 +41,7 @@ Invoke this skill when you need to perform the `scaffold` operation. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/security/SKILL.md b/.claude/skills/security/SKILL.md index 691dc094..e72a2fc5 100644 --- a/.claude/skills/security/SKILL.md +++ b/.claude/skills/security/SKILL.md @@ -3,14 +3,14 @@ name: 'security' description: 'Runs security-focused analysis: dependency vulnerability scanning, secret detection, OWASP compliance checks, and permission auditing. Generates a security report with severity ratings.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # security @@ -65,7 +65,7 @@ Produce: Executive Summary, Risk Score, Findings by severity (with ID, file:line ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/start/SKILL.md b/.claude/skills/start/SKILL.md index ff9fa10a..2e86db13 100644 --- a/.claude/skills/start/SKILL.md +++ b/.claude/skills/start/SKILL.md @@ -3,14 +3,14 @@ name: 'start' description: 'New user entry point. Detects repository state, shows contextual status, and guides users to the right command or team for their goal. Read-only — suggests commands but does not execute them.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # start @@ -114,7 +114,7 @@ This command is **read-only**. It reads state files for context detection but do ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/sync-backlog/SKILL.md b/.claude/skills/sync-backlog/SKILL.md index 229d2465..646540d1 100644 --- a/.claude/skills/sync-backlog/SKILL.md +++ b/.claude/skills/sync-backlog/SKILL.md @@ -3,14 +3,14 @@ name: 'sync-backlog' description: 'Synchronizes the local backlog with the configured issue tracker (GitHub or Linear), maps findings to ownership teams, updates local tracking documents, and identifies stale or unassigned work items.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # sync-backlog @@ -62,7 +62,7 @@ Priorities: P0 (blocking), P1 (high — this session), P2 (medium), P3 (low — ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/sync/SKILL.md b/.claude/skills/sync/SKILL.md index 4fd56943..c3c59053 100644 --- a/.claude/skills/sync/SKILL.md +++ b/.claude/skills/sync/SKILL.md @@ -3,14 +3,14 @@ name: 'sync' description: 'Regenerates all AI tool configurations from the AgentKit Forge spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # sync @@ -66,7 +66,7 @@ This command requires shell access (Bash tool). On platforms with restricted too ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/test/SKILL.md b/.claude/skills/test/SKILL.md index ed6d8864..d872a1f6 100644 --- a/.claude/skills/test/SKILL.md +++ b/.claude/skills/test/SKILL.md @@ -3,14 +3,14 @@ name: 'test' description: 'Runs the test suite using the detected tech stack's test command. Supports filtering by test file, pattern, or package. Reports pass/fail counts and coverage when available.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # test @@ -60,7 +60,7 @@ Report: framework, scope, exact command, summary table (Total/Passed/Failed/Skip ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.claude/skills/validate/SKILL.md b/.claude/skills/validate/SKILL.md index 35f2cc55..6a7b78a1 100644 --- a/.claude/skills/validate/SKILL.md +++ b/.claude/skills/validate/SKILL.md @@ -3,14 +3,14 @@ name: 'validate' description: 'Validates generated outputs for correctness. Checks that all required directories, JSON files, command files, and hook scripts exist and are well-formed. Scans for forbidden patterns (hardcoded secrets) and verifies the settings.json hooks configuration.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Claude skill definition. # Docs: https://docs.anthropic.com/en/docs/claude-code/memory --- - - - + + + # validate @@ -35,7 +35,7 @@ Report: per-check pass/fail with details, overall PASS/FAIL status, list of miss ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.clinerules/agent-conduct.md b/.clinerules/agent-conduct.md index b585bcf6..2b65b15a 100644 --- a/.clinerules/agent-conduct.md +++ b/.clinerules/agent-conduct.md @@ -1,4 +1,4 @@ - + diff --git a/.clinerules/ai-cost-ops.md b/.clinerules/ai-cost-ops.md index 71aee2e6..f4f4958a 100644 --- a/.clinerules/ai-cost-ops.md +++ b/.clinerules/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/blockchain.md b/.clinerules/blockchain.md index a3730370..e3a863f8 100644 --- a/.clinerules/blockchain.md +++ b/.clinerules/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/ci-cd.md b/.clinerules/ci-cd.md index 1034f8e0..d5e1fcff 100644 --- a/.clinerules/ci-cd.md +++ b/.clinerules/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/dependency-management.md b/.clinerules/dependency-management.md index 0be2169b..9403c036 100644 --- a/.clinerules/dependency-management.md +++ b/.clinerules/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/documentation.md b/.clinerules/documentation.md index bc2999c4..9b4e0d7e 100644 --- a/.clinerules/documentation.md +++ b/.clinerules/documentation.md @@ -1,4 +1,4 @@ - + diff --git a/.clinerules/dotnet.md b/.clinerules/dotnet.md index a104da83..f4f72f86 100644 --- a/.clinerules/dotnet.md +++ b/.clinerules/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/finops.md b/.clinerules/finops.md index 69ca807f..310e6deb 100644 --- a/.clinerules/finops.md +++ b/.clinerules/finops.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/git-workflow.md b/.clinerules/git-workflow.md index 1482f707..5d083fe0 100644 --- a/.clinerules/git-workflow.md +++ b/.clinerules/git-workflow.md @@ -1,4 +1,4 @@ - + diff --git a/.clinerules/iac.md b/.clinerules/iac.md index 6409581c..85bcdca1 100644 --- a/.clinerules/iac.md +++ b/.clinerules/iac.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/languages/README.md b/.clinerules/languages/README.md index afe5855e..531f558b 100644 --- a/.clinerules/languages/README.md +++ b/.clinerules/languages/README.md @@ -1,7 +1,7 @@ - - - - + + + + # Language-Specific Instructions @@ -10,7 +10,7 @@ This directory contains instruction files for **agentkit-forge**, one per rule domain defined in `.agentkit/spec/rules.yaml`. Each file provides language-specific coding conventions, testing patterns, and tooling requirements. -These files are generated by AgentKit Forge and deployed to each configured AI +These files are generated by Retort and deployed to each configured AI platform: | Platform | Output location | @@ -29,7 +29,7 @@ platform: ## How It Works -For each rule domain, AgentKit Forge renders a Markdown file using the +For each rule domain, Retort renders a Markdown file using the following template priority: 1. **Platform overlay** — `/language-instructions/.md` diff --git a/.clinerules/languages/agent-conduct.md b/.clinerules/languages/agent-conduct.md index dbc10857..09749ba5 100644 --- a/.clinerules/languages/agent-conduct.md +++ b/.clinerules/languages/agent-conduct.md @@ -1,4 +1,4 @@ - + # Instructions — agent-conduct diff --git a/.clinerules/languages/ai-cost-ops.md b/.clinerules/languages/ai-cost-ops.md index d924c4f4..29bc2a3d 100644 --- a/.clinerules/languages/ai-cost-ops.md +++ b/.clinerules/languages/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ai-cost-ops diff --git a/.clinerules/languages/blockchain.md b/.clinerules/languages/blockchain.md index 033a47be..6dbf76e3 100644 --- a/.clinerules/languages/blockchain.md +++ b/.clinerules/languages/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Blockchain / Smart Contracts diff --git a/.clinerules/languages/ci-cd.md b/.clinerules/languages/ci-cd.md index 501f6b92..5a51259d 100644 --- a/.clinerules/languages/ci-cd.md +++ b/.clinerules/languages/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ci-cd diff --git a/.clinerules/languages/dependency-management.md b/.clinerules/languages/dependency-management.md index 3447a4f0..a1e223e8 100644 --- a/.clinerules/languages/dependency-management.md +++ b/.clinerules/languages/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — dependency-management diff --git a/.clinerules/languages/documentation.md b/.clinerules/languages/documentation.md index 1f17dee9..ad2b59cc 100644 --- a/.clinerules/languages/documentation.md +++ b/.clinerules/languages/documentation.md @@ -1,4 +1,4 @@ - + # Instructions — documentation diff --git a/.clinerules/languages/dotnet.md b/.clinerules/languages/dotnet.md index 28cdeb94..a0b143fa 100644 --- a/.clinerules/languages/dotnet.md +++ b/.clinerules/languages/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — .NET / C# diff --git a/.clinerules/languages/finops.md b/.clinerules/languages/finops.md index caeb856c..34e716e2 100644 --- a/.clinerules/languages/finops.md +++ b/.clinerules/languages/finops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — finops diff --git a/.clinerules/languages/git-workflow.md b/.clinerules/languages/git-workflow.md index c0ffc0ff..188f6636 100644 --- a/.clinerules/languages/git-workflow.md +++ b/.clinerules/languages/git-workflow.md @@ -1,4 +1,4 @@ - + # Instructions — git-workflow diff --git a/.clinerules/languages/iac.md b/.clinerules/languages/iac.md index 9a60811c..4d5275be 100644 --- a/.clinerules/languages/iac.md +++ b/.clinerules/languages/iac.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Infrastructure as Code diff --git a/.clinerules/languages/python.md b/.clinerules/languages/python.md index 4b32df79..e306fb2d 100644 --- a/.clinerules/languages/python.md +++ b/.clinerules/languages/python.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Python diff --git a/.clinerules/languages/rust.md b/.clinerules/languages/rust.md index 449fe7d0..5bce7d63 100644 --- a/.clinerules/languages/rust.md +++ b/.clinerules/languages/rust.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Rust diff --git a/.clinerules/languages/security.md b/.clinerules/languages/security.md index 9f21e175..17c37314 100644 --- a/.clinerules/languages/security.md +++ b/.clinerules/languages/security.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — security diff --git a/.clinerules/languages/template-protection.md b/.clinerules/languages/template-protection.md index f7acfee9..78f276ce 100644 --- a/.clinerules/languages/template-protection.md +++ b/.clinerules/languages/template-protection.md @@ -1,4 +1,4 @@ - + # Instructions — template-protection diff --git a/.clinerules/languages/testing.md b/.clinerules/languages/testing.md index 64fe69b3..585420e0 100644 --- a/.clinerules/languages/testing.md +++ b/.clinerules/languages/testing.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — testing diff --git a/.clinerules/languages/typescript.md b/.clinerules/languages/typescript.md index feba3f0b..71a6101e 100644 --- a/.clinerules/languages/typescript.md +++ b/.clinerules/languages/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — TypeScript / JavaScript diff --git a/.clinerules/python.md b/.clinerules/python.md index 68c1e2ef..043404e9 100644 --- a/.clinerules/python.md +++ b/.clinerules/python.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/rust.md b/.clinerules/rust.md index 2a488be6..cdf79e83 100644 --- a/.clinerules/rust.md +++ b/.clinerules/rust.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/security.md b/.clinerules/security.md index 1a7b98c7..cd753b16 100644 --- a/.clinerules/security.md +++ b/.clinerules/security.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/template-protection.md b/.clinerules/template-protection.md index 4e134732..f0b68862 100644 --- a/.clinerules/template-protection.md +++ b/.clinerules/template-protection.md @@ -1,4 +1,4 @@ - + diff --git a/.clinerules/testing.md b/.clinerules/testing.md index 393817e1..cd3b4a1f 100644 --- a/.clinerules/testing.md +++ b/.clinerules/testing.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.clinerules/typescript.md b/.clinerules/typescript.md index 25cbd095..9d5ab450 100644 --- a/.clinerules/typescript.md +++ b/.clinerules/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.cursor/commands/analyze-agents.md b/.cursor/commands/analyze-agents.md index ebd0957e..fdc44e2a 100644 --- a/.cursor/commands/analyze-agents.md +++ b/.cursor/commands/analyze-agents.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Generates a comprehensive agent/team relationship matrix. Analyzes dependencies, ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/backlog.md b/.cursor/commands/backlog.md index 30278dc1..af8809ae 100644 --- a/.cursor/commands/backlog.md +++ b/.cursor/commands/backlog.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Displays a consolidated backlog view from all sources (external tracker, discove ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/brand.md b/.cursor/commands/brand.md index 45da02a5..ea149f9c 100644 --- a/.cursor/commands/brand.md +++ b/.cursor/commands/brand.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Manage the project brand spec (brand.yaml) and editor theme. Supports validation ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/build.md b/.cursor/commands/build.md index bfcc411d..87791bb1 100644 --- a/.cursor/commands/build.md +++ b/.cursor/commands/build.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -48,7 +48,7 @@ Report: detected stack, scope, exact command, status (PASS/FAIL), duration, arti ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/check.md b/.cursor/commands/check.md index e434c932..014c1fb6 100644 --- a/.cursor/commands/check.md +++ b/.cursor/commands/check.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -40,7 +40,7 @@ Produce: Quality Gate Results table (Step | Status | Duration | Details), Overal ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/cost-centres.md b/.cursor/commands/cost-centres.md index 3352fc1a..4293bb4e 100644 --- a/.cursor/commands/cost-centres.md +++ b/.cursor/commands/cost-centres.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Cost centre management for cloud infrastructure. Manages budget allocations, res ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/cost.md b/.cursor/commands/cost.md index 58869c96..2c71d65e 100644 --- a/.cursor/commands/cost.md +++ b/.cursor/commands/cost.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -33,7 +33,7 @@ Session cost and usage tracking. Shows session summaries, lists recent sessions, ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/deploy.md b/.cursor/commands/deploy.md index 563fbfac..6c36251b 100644 --- a/.cursor/commands/deploy.md +++ b/.cursor/commands/deploy.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -54,7 +54,7 @@ Report: service, environment, platform, status, timeline, command output, post-d ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/discover.md b/.cursor/commands/discover.md index 23673364..cf569353 100644 --- a/.cursor/commands/discover.md +++ b/.cursor/commands/discover.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -36,7 +36,7 @@ Create or update `AGENT_TEAMS.md` with: Repository Profile (primary stack, build ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/doctor.md b/.cursor/commands/doctor.md index 520eb4cc..32d386c2 100644 --- a/.cursor/commands/doctor.md +++ b/.cursor/commands/doctor.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -25,7 +25,7 @@ Runs AgentKit Forge diagnostics: spec validation, overlay sanity checks, templat ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/document-history.md b/.cursor/commands/document-history.md index dd00746d..03e7f5d6 100644 --- a/.cursor/commands/document-history.md +++ b/.cursor/commands/document-history.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Creates a structured history document from templates for significant work comple ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/expand.md b/.cursor/commands/expand.md index 2fe301c0..d1604ea2 100644 --- a/.cursor/commands/expand.md +++ b/.cursor/commands/expand.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Runs the expansion analyzer to identify gaps, missing capabilities, undocumented ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/feature-configure.md b/.cursor/commands/feature-configure.md index 96769115..1aca9def 100644 --- a/.cursor/commands/feature-configure.md +++ b/.cursor/commands/feature-configure.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Interactive feature configuration workflow. Walks through each feature category, ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/feature-flow.md b/.cursor/commands/feature-flow.md index 92260bee..bb8b8036 100644 --- a/.cursor/commands/feature-flow.md +++ b/.cursor/commands/feature-flow.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Traces a specific feature end-to-end through the kit: shows which spec files def ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/feature-review.md b/.cursor/commands/feature-review.md index 900b8e3f..ebb6dd72 100644 --- a/.cursor/commands/feature-review.md +++ b/.cursor/commands/feature-review.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Reviews the current feature configuration for the repo. Analyzes which features ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/format.md b/.cursor/commands/format.md index 59258690..f94b9ef0 100644 --- a/.cursor/commands/format.md +++ b/.cursor/commands/format.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -45,7 +45,7 @@ Report: formatters run, scope, mode, files changed/needing formatting, summary c ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/import-issues.md b/.cursor/commands/import-issues.md index 7bd48847..5d47da38 100644 --- a/.cursor/commands/import-issues.md +++ b/.cursor/commands/import-issues.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Imports issues from the configured external tracker (GitHub or Linear), normaliz ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/infra-eval.md b/.cursor/commands/infra-eval.md index 078042e3..7fade14a 100644 --- a/.cursor/commands/infra-eval.md +++ b/.cursor/commands/infra-eval.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -11,7 +11,7 @@ Risk-aware infrastructure and codebase evaluation against reliability, cost, and ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -21,7 +21,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/orchestrate.md b/.cursor/commands/orchestrate.md index c3225781..ba1e4249 100644 --- a/.cursor/commands/orchestrate.md +++ b/.cursor/commands/orchestrate.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -44,7 +44,7 @@ Produce a summary with: Actions Taken, Files Changed, Validation Commands, Updat ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/plan.md b/.cursor/commands/plan.md index c0cb272a..8c0449e9 100644 --- a/.cursor/commands/plan.md +++ b/.cursor/commands/plan.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -34,7 +34,7 @@ You are the **Planning Agent**. Produce detailed, structured implementation plan ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/preflight.md b/.cursor/commands/preflight.md index 787137e5..8522a826 100644 --- a/.cursor/commands/preflight.md +++ b/.cursor/commands/preflight.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -30,7 +30,7 @@ If `--range` is omitted, auto-detect via merge-base against the default branch. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/project-status.md b/.cursor/commands/project-status.md index 1b1f4c3d..07a2101f 100644 --- a/.cursor/commands/project-status.md +++ b/.cursor/commands/project-status.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -109,7 +109,7 @@ Produce markdown (default) or JSON (with `--format json`) with these sections: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/review.md b/.cursor/commands/review.md index d775e749..960c2d27 100644 --- a/.cursor/commands/review.md +++ b/.cursor/commands/review.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -52,7 +52,7 @@ Produce: Summary, Required Changes (must fix, with file:line references), Sugges ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/scaffold.md b/.cursor/commands/scaffold.md index b286dd37..13739ff5 100644 --- a/.cursor/commands/scaffold.md +++ b/.cursor/commands/scaffold.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -30,7 +30,7 @@ Generates implementation skeletons aligned with project conventions. Supports en ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/security.md b/.cursor/commands/security.md index d0b23d2b..ad5b605b 100644 --- a/.cursor/commands/security.md +++ b/.cursor/commands/security.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -54,7 +54,7 @@ Produce: Executive Summary, Risk Score, Findings by severity (with ID, file:line ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/start.md b/.cursor/commands/start.md index c5dc3fae..b2764453 100644 --- a/.cursor/commands/start.md +++ b/.cursor/commands/start.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -103,7 +103,7 @@ This command is **read-only**. It reads state files for context detection but do ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/sync-backlog.md b/.cursor/commands/sync-backlog.md index 4adbe1e6..f9851d65 100644 --- a/.cursor/commands/sync-backlog.md +++ b/.cursor/commands/sync-backlog.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -51,7 +51,7 @@ Priorities: P0 (blocking), P1 (high — this session), P2 (medium), P3 (low — ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/sync.md b/.cursor/commands/sync.md index ed082299..f4f386f5 100644 --- a/.cursor/commands/sync.md +++ b/.cursor/commands/sync.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -55,7 +55,7 @@ This command requires shell access (Bash tool). On platforms with restricted too ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/test.md b/.cursor/commands/test.md index 1b28fd18..ed3401d4 100644 --- a/.cursor/commands/test.md +++ b/.cursor/commands/test.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -49,7 +49,7 @@ Report: framework, scope, exact command, summary table (Total/Passed/Failed/Skip ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/commands/validate.md b/.cursor/commands/validate.md index 5e2cd3b6..0a334381 100644 --- a/.cursor/commands/validate.md +++ b/.cursor/commands/validate.md @@ -1,7 +1,7 @@ - - - - + + + + @@ -24,7 +24,7 @@ Report: per-check pass/fail with details, overall PASS/FAIL status, list of miss ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.cursor/rules/languages/README.md b/.cursor/rules/languages/README.md index afe5855e..531f558b 100644 --- a/.cursor/rules/languages/README.md +++ b/.cursor/rules/languages/README.md @@ -1,7 +1,7 @@ - - - - + + + + # Language-Specific Instructions @@ -10,7 +10,7 @@ This directory contains instruction files for **agentkit-forge**, one per rule domain defined in `.agentkit/spec/rules.yaml`. Each file provides language-specific coding conventions, testing patterns, and tooling requirements. -These files are generated by AgentKit Forge and deployed to each configured AI +These files are generated by Retort and deployed to each configured AI platform: | Platform | Output location | @@ -29,7 +29,7 @@ platform: ## How It Works -For each rule domain, AgentKit Forge renders a Markdown file using the +For each rule domain, Retort renders a Markdown file using the following template priority: 1. **Platform overlay** — `/language-instructions/.md` diff --git a/.cursor/rules/languages/agent-conduct.md b/.cursor/rules/languages/agent-conduct.md index dbc10857..09749ba5 100644 --- a/.cursor/rules/languages/agent-conduct.md +++ b/.cursor/rules/languages/agent-conduct.md @@ -1,4 +1,4 @@ - + # Instructions — agent-conduct diff --git a/.cursor/rules/languages/ai-cost-ops.md b/.cursor/rules/languages/ai-cost-ops.md index d924c4f4..29bc2a3d 100644 --- a/.cursor/rules/languages/ai-cost-ops.md +++ b/.cursor/rules/languages/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ai-cost-ops diff --git a/.cursor/rules/languages/blockchain.md b/.cursor/rules/languages/blockchain.md index 033a47be..6dbf76e3 100644 --- a/.cursor/rules/languages/blockchain.md +++ b/.cursor/rules/languages/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Blockchain / Smart Contracts diff --git a/.cursor/rules/languages/ci-cd.md b/.cursor/rules/languages/ci-cd.md index 501f6b92..5a51259d 100644 --- a/.cursor/rules/languages/ci-cd.md +++ b/.cursor/rules/languages/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ci-cd diff --git a/.cursor/rules/languages/dependency-management.md b/.cursor/rules/languages/dependency-management.md index 3447a4f0..a1e223e8 100644 --- a/.cursor/rules/languages/dependency-management.md +++ b/.cursor/rules/languages/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — dependency-management diff --git a/.cursor/rules/languages/documentation.md b/.cursor/rules/languages/documentation.md index 1f17dee9..ad2b59cc 100644 --- a/.cursor/rules/languages/documentation.md +++ b/.cursor/rules/languages/documentation.md @@ -1,4 +1,4 @@ - + # Instructions — documentation diff --git a/.cursor/rules/languages/dotnet.md b/.cursor/rules/languages/dotnet.md index 28cdeb94..a0b143fa 100644 --- a/.cursor/rules/languages/dotnet.md +++ b/.cursor/rules/languages/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — .NET / C# diff --git a/.cursor/rules/languages/finops.md b/.cursor/rules/languages/finops.md index caeb856c..34e716e2 100644 --- a/.cursor/rules/languages/finops.md +++ b/.cursor/rules/languages/finops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — finops diff --git a/.cursor/rules/languages/git-workflow.md b/.cursor/rules/languages/git-workflow.md index c0ffc0ff..188f6636 100644 --- a/.cursor/rules/languages/git-workflow.md +++ b/.cursor/rules/languages/git-workflow.md @@ -1,4 +1,4 @@ - + # Instructions — git-workflow diff --git a/.cursor/rules/languages/iac.md b/.cursor/rules/languages/iac.md index 9a60811c..4d5275be 100644 --- a/.cursor/rules/languages/iac.md +++ b/.cursor/rules/languages/iac.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Infrastructure as Code diff --git a/.cursor/rules/languages/python.md b/.cursor/rules/languages/python.md index 4b32df79..e306fb2d 100644 --- a/.cursor/rules/languages/python.md +++ b/.cursor/rules/languages/python.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Python diff --git a/.cursor/rules/languages/rust.md b/.cursor/rules/languages/rust.md index 449fe7d0..5bce7d63 100644 --- a/.cursor/rules/languages/rust.md +++ b/.cursor/rules/languages/rust.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Rust diff --git a/.cursor/rules/languages/security.md b/.cursor/rules/languages/security.md index 9f21e175..17c37314 100644 --- a/.cursor/rules/languages/security.md +++ b/.cursor/rules/languages/security.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — security diff --git a/.cursor/rules/languages/template-protection.md b/.cursor/rules/languages/template-protection.md index f7acfee9..78f276ce 100644 --- a/.cursor/rules/languages/template-protection.md +++ b/.cursor/rules/languages/template-protection.md @@ -1,4 +1,4 @@ - + # Instructions — template-protection diff --git a/.cursor/rules/languages/testing.md b/.cursor/rules/languages/testing.md index 64fe69b3..585420e0 100644 --- a/.cursor/rules/languages/testing.md +++ b/.cursor/rules/languages/testing.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — testing diff --git a/.cursor/rules/languages/typescript.md b/.cursor/rules/languages/typescript.md index feba3f0b..71a6101e 100644 --- a/.cursor/rules/languages/typescript.md +++ b/.cursor/rules/languages/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — TypeScript / JavaScript diff --git a/.cursor/rules/orchestrate.mdc b/.cursor/rules/orchestrate.mdc index 5e19cff8..9a810cab 100644 --- a/.cursor/rules/orchestrate.mdc +++ b/.cursor/rules/orchestrate.mdc @@ -1,6 +1,6 @@ - + # Orchestration Follow the 5-phase lifecycle: Discovery → Planning → Implementation → Validation → Ship. diff --git a/.cursor/rules/project-context.mdc b/.cursor/rules/project-context.mdc index 0e435d5d..71dc27ba 100644 --- a/.cursor/rules/project-context.mdc +++ b/.cursor/rules/project-context.mdc @@ -3,7 +3,7 @@ # Project Context -This repository uses the AgentKit Forge unified agent team framework (v3.1.0). +This repository uses the Retort unified agent team framework (v3.1.0). ## Language Profile Diagnostics - Source: configured (confidence: high) @@ -32,4 +32,4 @@ This repository uses the AgentKit Forge unified agent team framework (v3.1.0). - Always include validation commands in summaries - PR titles must use Conventional Commits format: `type(scope): description` — CI rejects non-conforming titles - Breaking changes (`!:` or `BREAKING` in PR title) require a `## Breaking Changes` section in the PR body -- Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT` — modify `.agentkit/spec/` and run sync +- Never edit files marked `GENERATED by Retort — DO NOT EDIT` — modify `.agentkit/spec/` and run sync diff --git a/.cursor/rules/security.mdc b/.cursor/rules/security.mdc index 2287c4ba..7089af6b 100644 --- a/.cursor/rules/security.mdc +++ b/.cursor/rules/security.mdc @@ -1,6 +1,6 @@ - + # Security Rules - Never read, print, or commit secrets or tokens - Prefer least privilege and deny-by-default diff --git a/.cursor/rules/team-backend.mdc b/.cursor/rules/team-backend.mdc index fe12df04..3f45a32e 100644 --- a/.cursor/rules/team-backend.mdc +++ b/.cursor/rules/team-backend.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ apps/api/**, services/**, src/server/**, controllers/** - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-cost-ops.mdc b/.cursor/rules/team-cost-ops.mdc index 96180000..42d4f452 100644 --- a/.cursor/rules/team-cost-ops.mdc +++ b/.cursor/rules/team-cost-ops.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ docs/cost-ops/**, docs/planning/cost/**, config/models/**, config/pricing/** - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-data.mdc b/.cursor/rules/team-data.mdc index 63557411..bf523e93 100644 --- a/.cursor/rules/team-data.mdc +++ b/.cursor/rules/team-data.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ db/**, migrations/**, models/**, prisma/** - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-devops.mdc b/.cursor/rules/team-devops.mdc index f43dec6f..1e98654e 100644 --- a/.cursor/rules/team-devops.mdc +++ b/.cursor/rules/team-devops.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-docs.mdc b/.cursor/rules/team-docs.mdc index 6412e0c3..b4ba4670 100644 --- a/.cursor/rules/team-docs.mdc +++ b/.cursor/rules/team-docs.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ docs/**, docs/architecture/decisions/**, .github/**, README.md, CHANGELOG.md, CO - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-forge.mdc b/.cursor/rules/team-forge.mdc index fe55ad20..ca27035f 100644 --- a/.cursor/rules/team-forge.mdc +++ b/.cursor/rules/team-forge.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-frontend.mdc b/.cursor/rules/team-frontend.mdc index dd5d235c..8a6641d0 100644 --- a/.cursor/rules/team-frontend.mdc +++ b/.cursor/rules/team-frontend.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ apps/web/**, apps/marketing/**, src/client/**, components/** - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-infra.mdc b/.cursor/rules/team-infra.mdc index 828bd3cf..1d6c57e0 100644 --- a/.cursor/rules/team-infra.mdc +++ b/.cursor/rules/team-infra.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ infra/**, terraform/**, bicep/**, pulumi/** - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-product.mdc b/.cursor/rules/team-product.mdc index 3e90d5b1..c119f2e5 100644 --- a/.cursor/rules/team-product.mdc +++ b/.cursor/rules/team-product.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ docs/product/**, docs/prd/** - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-quality.mdc b/.cursor/rules/team-quality.mdc index 6babd039..a6a545c6 100644 --- a/.cursor/rules/team-quality.mdc +++ b/.cursor/rules/team-quality.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-security.mdc b/.cursor/rules/team-security.mdc index 4c78c5aa..d863f32d 100644 --- a/.cursor/rules/team-security.mdc +++ b/.cursor/rules/team-security.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ auth/**, security/**, middleware/auth* - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-strategic-ops.mdc b/.cursor/rules/team-strategic-ops.mdc index 62713df0..dbe715bb 100644 --- a/.cursor/rules/team-strategic-ops.mdc +++ b/.cursor/rules/team-strategic-ops.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ docs/planning/**, docs/architecture/**, .agentkit/spec/**, AGENT_BACKLOG.md, UNI - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.cursor/rules/team-testing.mdc b/.cursor/rules/team-testing.mdc index 1f32be1d..9c7f012f 100644 --- a/.cursor/rules/team-testing.mdc +++ b/.cursor/rules/team-testing.mdc @@ -4,7 +4,7 @@ globs: [] alwaysApply: false generated_by: "agentkit-forge" last_model: "sync-engine" -last_updated: "2026-03-17" +last_updated: "2026-03-21" # Format: MDC (Markdown with YAML frontmatter). Cursor team rule. # Docs: https://docs.cursor.com/context/rules --- @@ -29,6 +29,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.gemini/config.yaml b/.gemini/config.yaml index efd7112a..c8abcc55 100644 --- a/.gemini/config.yaml +++ b/.gemini/config.yaml @@ -1,8 +1,8 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # Gemini Code Assist configuration -# Generated by AgentKit Forge — see .agentkit/ for source +# Generated by Retort — see .agentkit/ for source # Format: YAML config for Gemini Code Assist code review behaviour. # Docs: https://developers.google.com/gemini-code-assist/docs/customize-gemini-behavior-github diff --git a/.gemini/styleguide.md b/.gemini/styleguide.md index 51d412e0..1d360632 100644 --- a/.gemini/styleguide.md +++ b/.gemini/styleguide.md @@ -1,11 +1,11 @@ - - - - + + + + -# Style Guide — agentkit-forge +# Style Guide — retort This style guide is auto-generated from the project's rule definitions. See `AGENTS.md` for universal project conventions. diff --git a/.gitattributes b/.gitattributes index a5e34706..9e3aaa8c 100644 --- a/.gitattributes +++ b/.gitattributes @@ -21,12 +21,38 @@ *.ttf binary *.eot binary -# >>> Retort merge drivers — DO NOT EDIT below this line -# GENERATED by Retort v3.1.0 — regenerated on every sync. +# ============================================================================= +# Merge drivers — auto-resolve conflicts on generated / framework-managed files +# ============================================================================= +# These rules use custom merge drivers defined in .gitconfig (repo-local) or +# the user's global config. Run `git config --local include.path ../.gitattributes-drivers` +# or the setup script to activate them. +# +# Driver: agentkit-generated — always accept the incoming (upstream) version +# for files that are regenerated by `agentkit sync` and should never diverge. +# ============================================================================= + +# --- Generated agent/skill/prompt packs (always accept upstream) --- +.agents/skills/**/SKILL.md merge=agentkit-generated +.github/agents/*.agent.md merge=agentkit-generated +.github/chatmodes/*.chatmode.md merge=agentkit-generated +.github/prompts/*.prompt.md merge=agentkit-generated + +# --- Generated doc indexes (always accept upstream) --- +docs/*/README.md merge=agentkit-generated + +# --- Generated config files (always accept upstream) --- +.github/copilot-instructions.md merge=agentkit-generated +.github/PULL_REQUEST_TEMPLATE.md merge=agentkit-generated + +# --- Lock files (accept upstream, regenerate after merge) --- +pnpm-lock.yaml merge=agentkit-generated +.agentkit/pnpm-lock.yaml merge=agentkit-generated + +# >>> AgentKit Forge merge drivers — DO NOT EDIT below this line +# GENERATED by AgentKit Forge v3.1.0 — regenerated on every sync. # These custom merge drivers auto-resolve conflicts on framework-managed files. # Driver "agentkit-generated" accepts the incoming (upstream/theirs) version. -# Only scaffold:always files are listed — scaffold:managed files (CLAUDE.md, -# settings.json, etc.) are intentionally excluded so user edits are preserved. # # To activate locally, run: # git config merge.agentkit-generated.name "Accept upstream for generated files" @@ -34,43 +60,48 @@ # # Or use: scripts/resolve-merge.sh -# --- Claude Code: agents, commands, rules, hooks, skills --- -.claude/agents/*.md merge=agentkit-generated -.claude/commands/*.md merge=agentkit-generated -.claude/rules/**/*.md merge=agentkit-generated -.claude/hooks/*.sh merge=agentkit-generated -.claude/hooks/*.ps1 merge=agentkit-generated -.claude/skills/**/SKILL.md merge=agentkit-generated +# --- Generated agent/skill/prompt packs (always accept upstream) --- +.agents/skills/**/SKILL.md merge=agentkit-generated +.github/agents/*.agent.md merge=agentkit-generated +.github/chatmodes/*.chatmode.md merge=agentkit-generated +.github/prompts/*.prompt.md merge=agentkit-generated -# --- Cursor: commands and rules --- -.cursor/commands/*.md merge=agentkit-generated -.cursor/rules/**/*.md merge=agentkit-generated +# --- Generated doc indexes (always accept upstream) --- +docs/*/README.md merge=agentkit-generated -# --- Windsurf: commands, rules, and workflows --- -.windsurf/commands/*.md merge=agentkit-generated -.windsurf/rules/**/*.md merge=agentkit-generated -.windsurf/workflows/*.yml merge=agentkit-generated +# --- Generated config files (always accept upstream) --- +.github/copilot-instructions.md merge=agentkit-generated +.github/PULL_REQUEST_TEMPLATE.md merge=agentkit-generated -# --- Cline rules --- -.clinerules/**/*.md merge=agentkit-generated +# --- Lock files (accept upstream, regenerate after merge) --- +pnpm-lock.yaml merge=agentkit-generated +.agentkit/pnpm-lock.yaml merge=agentkit-generated +# <<< AgentKit Forge merge drivers — DO NOT EDIT above this line -# --- Roo rules --- -.roo/rules/**/*.md merge=agentkit-generated +# >>> Retort merge drivers — DO NOT EDIT below this line +# GENERATED by Retort v3.1.0 — regenerated on every sync. +# These custom merge drivers auto-resolve conflicts on framework-managed files. +# Driver "agentkit-generated" accepts the incoming (upstream/theirs) version. +# +# To activate locally, run: +# git config merge.agentkit-generated.name "Accept upstream for generated files" +# git config merge.agentkit-generated.driver "cp %B %A" +# +# Or use: scripts/resolve-merge.sh -# --- GitHub Copilot: instructions, agents, chatmodes, prompts --- -.github/instructions/**/*.md merge=agentkit-generated +# --- Generated agent/skill/prompt packs (always accept upstream) --- +.agents/skills/**/SKILL.md merge=agentkit-generated .github/agents/*.agent.md merge=agentkit-generated .github/chatmodes/*.chatmode.md merge=agentkit-generated .github/prompts/*.prompt.md merge=agentkit-generated -.github/copilot-instructions.md merge=agentkit-generated -.github/PULL_REQUEST_TEMPLATE.md merge=agentkit-generated -# --- Agent skills packs --- -.agents/skills/**/SKILL.md merge=agentkit-generated - -# --- Generated doc indexes --- +# --- Generated doc indexes (always accept upstream) --- docs/*/README.md merge=agentkit-generated +# --- Generated config files (always accept upstream) --- +.github/copilot-instructions.md merge=agentkit-generated +.github/PULL_REQUEST_TEMPLATE.md merge=agentkit-generated + # --- Lock files (accept upstream, regenerate after merge) --- pnpm-lock.yaml merge=agentkit-generated .agentkit/pnpm-lock.yaml merge=agentkit-generated diff --git a/.github/agents/adoption-strategist.agent.md b/.github/agents/adoption-strategist.agent.md index bf792b3f..0b610684 100644 --- a/.github/agents/adoption-strategist.agent.md +++ b/.github/agents/adoption-strategist.agent.md @@ -3,7 +3,7 @@ name: 'Adoption Strategist' description: 'Plans and executes adoption campaigns — onboarding new repos, migration paths for existing projects, and rollout strategies for new framework features across the portfolio.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Plans and executes adoption campaigns — onboarding new repos, migration paths ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -71,7 +71,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/backend.agent.md b/.github/agents/backend.agent.md index 6edafe74..59b78e4f 100644 --- a/.github/agents/backend.agent.md +++ b/.github/agents/backend.agent.md @@ -3,7 +3,7 @@ name: 'Backend Engineer' description: 'Senior backend engineer responsible for API design, service architecture, core business logic, and server-side performance. Ensures clean separation of concerns and robust error handling.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Senior backend engineer responsible for API design, service architecture, core b ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -101,7 +101,7 @@ export function registerBillingServices(container) { - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/brand-guardian.agent.md b/.github/agents/brand-guardian.agent.md index e100b3b4..82550aec 100644 --- a/.github/agents/brand-guardian.agent.md +++ b/.github/agents/brand-guardian.agent.md @@ -3,7 +3,7 @@ name: 'Brand Guardian' description: 'Brand consistency specialist ensuring all visual and written outputs align with the established brand identity, design tokens, and style guidelines across all touchpoints. The canonical brand source of truth is .agentkit/spec/brand.yaml; editor theming is configured in .agentkit/spec/editor-theme.yaml. Use /brand to validate, preview, scaffold, or regenerate brand assets.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Brand consistency specialist ensuring all visual and written outputs align with ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -139,7 +139,7 @@ mappings: - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/content-strategist.agent.md b/.github/agents/content-strategist.agent.md index f6d262fa..024f96b1 100644 --- a/.github/agents/content-strategist.agent.md +++ b/.github/agents/content-strategist.agent.md @@ -3,7 +3,7 @@ name: 'Content Strategist' description: 'Content strategy specialist responsible for messaging, copy, documentation voice, and content architecture. Ensures clear, consistent, and audience-appropriate communication.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Content strategy specialist responsible for messaging, copy, documentation voice ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -77,7 +77,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/cost-ops-monitor.agent.md b/.github/agents/cost-ops-monitor.agent.md index 09ffcdfc..aefd83c4 100644 --- a/.github/agents/cost-ops-monitor.agent.md +++ b/.github/agents/cost-ops-monitor.agent.md @@ -3,7 +3,7 @@ name: 'Cost Ops Monitor' description: 'Central monitoring and reporting agent for the Cost Ops team. Aggregates cost data from all agents, produces dashboards, sets budget alerts, and triggers escalation when spend exceeds thresholds. Maintains the cost ops cadence (weekly reviews, monthly deep dives, quarterly strategy).' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Central monitoring and reporting agent for the Cost Ops team. Aggregates cost da ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -83,7 +83,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/coverage-tracker.agent.md b/.github/agents/coverage-tracker.agent.md index ba82668b..d9e992b6 100644 --- a/.github/agents/coverage-tracker.agent.md +++ b/.github/agents/coverage-tracker.agent.md @@ -3,7 +3,7 @@ name: 'Coverage Tracker' description: 'Test coverage analysis specialist monitoring code coverage metrics, identifying untested code paths, and enforcing coverage thresholds across the codebase.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Test coverage analysis specialist monitoring code coverage metrics, identifying ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -77,7 +77,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/data.agent.md b/.github/agents/data.agent.md index 614f1197..a54da03c 100644 --- a/.github/agents/data.agent.md +++ b/.github/agents/data.agent.md @@ -3,7 +3,7 @@ name: 'Data Engineer' description: 'Senior data engineer responsible for database design, migrations, data models, and data pipeline architecture. Ensures data integrity, query performance, and safe schema evolution.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Senior data engineer responsible for database design, migrations, data models, a ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -107,7 +107,7 @@ ALTER TABLE users ADD COLUMN timezone TEXT NULL; - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/dependency-watcher.agent.md b/.github/agents/dependency-watcher.agent.md index 7fed0213..10826a14 100644 --- a/.github/agents/dependency-watcher.agent.md +++ b/.github/agents/dependency-watcher.agent.md @@ -3,7 +3,7 @@ name: 'Dependency Watcher' description: 'Dependency management specialist responsible for monitoring, updating, and auditing project dependencies across all tech stacks. Ensures supply chain security and version freshness. During code review, validates that new or updated dependencies are well-maintained, license-compatible, and free of known vulnerabilities.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Dependency management specialist responsible for monitoring, updating, and audit ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -81,7 +81,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/devops.agent.md b/.github/agents/devops.agent.md index 012e152e..c37e56d3 100644 --- a/.github/agents/devops.agent.md +++ b/.github/agents/devops.agent.md @@ -3,7 +3,7 @@ name: 'DevOps Engineer' description: 'Senior DevOps engineer responsible for CI/CD pipelines, build automation, container orchestration, and deployment workflows. Ensures reliable, repeatable, and fast delivery pipelines.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Senior DevOps engineer responsible for CI/CD pipelines, build automation, contai ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -81,7 +81,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/environment-manager.agent.md b/.github/agents/environment-manager.agent.md index 05e75256..a4564281 100644 --- a/.github/agents/environment-manager.agent.md +++ b/.github/agents/environment-manager.agent.md @@ -3,7 +3,7 @@ name: 'Environment Manager' description: 'Environment configuration specialist ensuring consistent, secure, and documented environment setups across development, CI, staging, and production.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Environment configuration specialist ensuring consistent, secure, and documented ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -79,7 +79,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/expansion-analyst.agent.md b/.github/agents/expansion-analyst.agent.md index 5d7fc14a..3da21130 100644 --- a/.github/agents/expansion-analyst.agent.md +++ b/.github/agents/expansion-analyst.agent.md @@ -3,7 +3,7 @@ name: 'Expansion Analyst' description: 'Strategic analysis agent that identifies gaps, missing capabilities, undocumented decisions, and improvement opportunities in the codebase. Produces ranked suggestions with rationale and can generate draft specification documents for approved suggestions. Never acts autonomously — all suggestions require explicit human approval before any downstream action occurs.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Strategic analysis agent that identifies gaps, missing capabilities, undocumente ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -86,7 +86,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/feature-ops.agent.md b/.github/agents/feature-ops.agent.md index b3bc3d1c..18882623 100644 --- a/.github/agents/feature-ops.agent.md +++ b/.github/agents/feature-ops.agent.md @@ -3,7 +3,7 @@ name: 'Feature Operations Specialist' description: 'Kit feature management specialist responsible for analyzing, configuring, and auditing the agentkit-forge feature set for this repository. Understands the full feature dependency graph, overlay precedence rules, and how features map to template output. Helps teams adopt the right features for their workflow and troubleshoot feature configuration issues.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Kit feature management specialist responsible for analyzing, configuring, and au ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -118,7 +118,7 @@ agentkit features disable team-orchestration agent-personas - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/flow-designer.agent.md b/.github/agents/flow-designer.agent.md index bce8b615..d6869bb1 100644 --- a/.github/agents/flow-designer.agent.md +++ b/.github/agents/flow-designer.agent.md @@ -3,7 +3,7 @@ name: 'Flow Designer' description: 'Designs the team command, flags, and integration points with other teams. Creates the command entry in commands.yaml and ensures the team is properly wired into the intake routing system.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Designs the team command, flags, and integration points with other teams. Create ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -70,7 +70,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/frontend.agent.md b/.github/agents/frontend.agent.md index 0ddbeb1c..81a73a23 100644 --- a/.github/agents/frontend.agent.md +++ b/.github/agents/frontend.agent.md @@ -3,7 +3,7 @@ name: 'Frontend Engineer' description: 'Senior frontend engineer responsible for UI implementation, component architecture, state management, and user experience. Champions accessibility, performance, and responsive design.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Senior frontend engineer responsible for UI implementation, component architectu ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -106,7 +106,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/governance-advisor.agent.md b/.github/agents/governance-advisor.agent.md index 22e51ed4..23e241fc 100644 --- a/.github/agents/governance-advisor.agent.md +++ b/.github/agents/governance-advisor.agent.md @@ -3,7 +3,7 @@ name: 'Governance Advisor' description: 'Defines and enforces framework governance policies — versioning strategy, breaking change protocols, deprecation timelines, and cross-repo consistency standards.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Defines and enforces framework governance policies — versioning strategy, brea ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -71,7 +71,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/grant-hunter.agent.md b/.github/agents/grant-hunter.agent.md index 5338b903..d568f423 100644 --- a/.github/agents/grant-hunter.agent.md +++ b/.github/agents/grant-hunter.agent.md @@ -3,7 +3,7 @@ name: 'Grant & Programs Hunter' description: 'Identifies and pursues external funding sources for AI infrastructure costs: research grants, startup accelerator credits, academic partnerships, bug bounty programs, community contribution rewards, and referral bonuses. Maintains an active pipeline of applications.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Identifies and pursues external funding sources for AI infrastructure costs: res ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -83,7 +83,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/growth-analyst.agent.md b/.github/agents/growth-analyst.agent.md index e6de46d2..5f614ae2 100644 --- a/.github/agents/growth-analyst.agent.md +++ b/.github/agents/growth-analyst.agent.md @@ -3,7 +3,7 @@ name: 'Growth Analyst' description: 'Growth and analytics specialist focused on user acquisition, activation, retention, and revenue metrics. Translates data into actionable product and marketing recommendations.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Growth and analytics specialist focused on user acquisition, activation, retenti ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -73,7 +73,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/impact-assessor.agent.md b/.github/agents/impact-assessor.agent.md index 8575e660..ed8a5c29 100644 --- a/.github/agents/impact-assessor.agent.md +++ b/.github/agents/impact-assessor.agent.md @@ -3,7 +3,7 @@ name: 'Impact Assessor' description: 'Evaluates the blast radius of proposed changes — estimates which repos, teams, and workflows are affected by template changes, spec modifications, or engine updates before they ship.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Evaluates the blast radius of proposed changes — estimates which repos, teams, ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -71,7 +71,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/infra.agent.md b/.github/agents/infra.agent.md index 817d2e88..eeaa2c5a 100644 --- a/.github/agents/infra.agent.md +++ b/.github/agents/infra.agent.md @@ -3,7 +3,7 @@ name: 'Infrastructure Engineer' description: 'Senior infrastructure engineer responsible for Infrastructure as Code, cloud resource management, and platform reliability. Ensures reproducible environments and cost-effective resource provisioning. Enforces the project naming convention {org}-{env}-{project}-{resourcetype}-{region} using project-configured defaults. Preferred IaC toolchain: Terraform + Terragrunt.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Senior infrastructure engineer responsible for Infrastructure as Code, cloud res ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -113,7 +113,7 @@ locals { - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/input-clarifier.agent.md b/.github/agents/input-clarifier.agent.md index 7baffdbf..8a32d541 100644 --- a/.github/agents/input-clarifier.agent.md +++ b/.github/agents/input-clarifier.agent.md @@ -3,7 +3,7 @@ name: 'Input Clarifier' description: 'Assesses raw team creation requests, extracts constraints, validates against existing teams to prevent scope overlap, and enriches the request with missing context before passing to the mission definer.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Assesses raw team creation requests, extracts constraints, validates against exi ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -71,7 +71,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/integration-tester.agent.md b/.github/agents/integration-tester.agent.md index 144c1e6c..495947e5 100644 --- a/.github/agents/integration-tester.agent.md +++ b/.github/agents/integration-tester.agent.md @@ -3,7 +3,7 @@ name: 'Integration Tester' description: 'Integration and end-to-end test specialist responsible for testing cross-service interactions, API contracts, and user workflow scenarios that span multiple system components.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Integration and end-to-end test specialist responsible for testing cross-service ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -79,7 +79,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/mission-definer.agent.md b/.github/agents/mission-definer.agent.md index 717a64db..010fd79e 100644 --- a/.github/agents/mission-definer.agent.md +++ b/.github/agents/mission-definer.agent.md @@ -3,7 +3,7 @@ name: 'Mission Definer' description: 'Locks the team mission, scope, accepted task types, and handoff chain. Produces a complete team definition entry for teams.yaml with all required fields validated against the schema.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Locks the team mission, scope, accepted task types, and handoff chain. Produces ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -69,7 +69,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/model-economist.agent.md b/.github/agents/model-economist.agent.md index 7bd90e90..96cb60b7 100644 --- a/.github/agents/model-economist.agent.md +++ b/.github/agents/model-economist.agent.md @@ -3,7 +3,7 @@ name: 'Model Economist' description: 'AI model selection and pricing specialist. Analyzes API pricing tiers across providers (Anthropic, OpenAI, Google, Mistral, Cohere), evaluates quality-cost tradeoffs for each use case, and maintains a model routing strategy that minimizes spend without degrading output quality.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ AI model selection and pricing specialist. Analyzes API pricing tiers across pro ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -82,7 +82,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/portfolio-analyst.agent.md b/.github/agents/portfolio-analyst.agent.md index c7649e31..f2a13bd0 100644 --- a/.github/agents/portfolio-analyst.agent.md +++ b/.github/agents/portfolio-analyst.agent.md @@ -3,7 +3,7 @@ name: 'Portfolio Analyst' description: 'Scans the adoption landscape — inventories downstream repos using AgentKit Forge, compares spec versions, detects drift, and maps the portfolio health across all managed projects.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Scans the adoption landscape — inventories downstream repos using AgentKit For ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -74,7 +74,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/product-manager.agent.md b/.github/agents/product-manager.agent.md index f3d0d3d5..ba2d68f3 100644 --- a/.github/agents/product-manager.agent.md +++ b/.github/agents/product-manager.agent.md @@ -3,7 +3,7 @@ name: 'Product Manager' description: 'Product management specialist responsible for feature definition, prioritization, requirements gathering, and stakeholder alignment. Translates business needs into actionable engineering work.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Product management specialist responsible for feature definition, prioritization ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -77,7 +77,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/project-shipper.agent.md b/.github/agents/project-shipper.agent.md index 543a74ce..e3c6eb64 100644 --- a/.github/agents/project-shipper.agent.md +++ b/.github/agents/project-shipper.agent.md @@ -3,7 +3,7 @@ name: 'Project Shipper' description: 'Delivery-focused project management specialist responsible for moving work through the pipeline from planning to production. Ensures tasks are properly scoped, tracked, and delivered.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Delivery-focused project management specialist responsible for moving work throu ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -82,7 +82,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/prompt-engineer.agent.md b/.github/agents/prompt-engineer.agent.md index 467a96cb..61cd61fe 100644 --- a/.github/agents/prompt-engineer.agent.md +++ b/.github/agents/prompt-engineer.agent.md @@ -3,7 +3,7 @@ name: 'Prompt Engineer' description: 'Writes agent descriptions, domain rules, conventions, anti-patterns, and examples for each agent in the new team. Ensures prompt quality and consistency with existing agent definitions.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Writes agent descriptions, domain rules, conventions, anti-patterns, and example ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -70,7 +70,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/release-coordinator.agent.md b/.github/agents/release-coordinator.agent.md index 1dbd0904..fe723014 100644 --- a/.github/agents/release-coordinator.agent.md +++ b/.github/agents/release-coordinator.agent.md @@ -3,7 +3,7 @@ name: 'Release Coordinator' description: 'Orchestrates framework releases — coordinates version bumps, changelog generation, cross-repo sync waves, and release communication across the portfolio.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Orchestrates framework releases — coordinates version bumps, changelog generat ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -72,7 +72,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/release-manager.agent.md b/.github/agents/release-manager.agent.md index a847054e..3b82e1f3 100644 --- a/.github/agents/release-manager.agent.md +++ b/.github/agents/release-manager.agent.md @@ -3,7 +3,7 @@ name: 'Release Manager' description: 'Release management specialist responsible for coordinating releases, managing versioning, generating changelogs, and ensuring smooth deployment workflows from staging to production. During code review, validates that breaking changes are documented, version bumps are correct, changelogs are updated, and deprecations are marked properly.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Release management specialist responsible for coordinating releases, managing ve ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -83,7 +83,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/retrospective-analyst.agent.md b/.github/agents/retrospective-analyst.agent.md index a6e3c01d..46768e3d 100644 --- a/.github/agents/retrospective-analyst.agent.md +++ b/.github/agents/retrospective-analyst.agent.md @@ -3,7 +3,7 @@ name: 'Retrospective Analyst' description: 'Session retrospective specialist activated via /review --focus=retrospective. Reviews conversation history and session activity to extract issues encountered and lessons learned. Produces structured, non-blocking records in docs/history/issues/ and docs/history/lessons-learned/ using project templates and sequential numbering. Cross-references findings with existing rules, ADRs, and history records to avoid duplication and surface patterns.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Session retrospective specialist activated via /review --focus=retrospective. Re ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -93,7 +93,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/roadmap-tracker.agent.md b/.github/agents/roadmap-tracker.agent.md index eee3a6b3..94e2dfd1 100644 --- a/.github/agents/roadmap-tracker.agent.md +++ b/.github/agents/roadmap-tracker.agent.md @@ -3,7 +3,7 @@ name: 'Roadmap Tracker' description: 'Roadmap and milestone tracking specialist maintaining visibility into project progress, timeline adherence, and delivery forecasting across all active workstreams.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Roadmap and milestone tracking specialist maintaining visibility into project pr ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -77,7 +77,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/role-architect.agent.md b/.github/agents/role-architect.agent.md index c7f5b962..1839aea7 100644 --- a/.github/agents/role-architect.agent.md +++ b/.github/agents/role-architect.agent.md @@ -3,7 +3,7 @@ name: 'Role Architect' description: 'Designs individual agent roles, responsibilities, dependencies, and notification chains for a new team. Produces complete agent entries for agents.yaml following the established schema.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Designs individual agent roles, responsibilities, dependencies, and notification ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -70,7 +70,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/security-auditor.agent.md b/.github/agents/security-auditor.agent.md index ca90e907..731bf294 100644 --- a/.github/agents/security-auditor.agent.md +++ b/.github/agents/security-auditor.agent.md @@ -3,7 +3,7 @@ name: 'Security Auditor' description: 'Security audit specialist performing continuous security analysis, vulnerability assessment, and compliance verification across the entire codebase and infrastructure.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Security audit specialist performing continuous security analysis, vulnerability ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -80,7 +80,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/spec-compliance-auditor.agent.md b/.github/agents/spec-compliance-auditor.agent.md index 5a8a4894..8333c37c 100644 --- a/.github/agents/spec-compliance-auditor.agent.md +++ b/.github/agents/spec-compliance-auditor.agent.md @@ -3,7 +3,7 @@ name: 'Spec Compliance Auditor' description: "Agent performance evaluator that closes the feedback loop between agent specifications and actual behavior. Compares task execution artifacts against the agent's defined role, responsibilities, and focus areas. Identifies spec drift, scope creep, quality gaps, and recommends spec revisions when actual behavior consistently deviates from declared capabilities." generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Agent performance evaluator that closes the feedback loop between agent specific ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -92,7 +92,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/team-validator.agent.md b/.github/agents/team-validator.agent.md index 61ff7517..b3781851 100644 --- a/.github/agents/team-validator.agent.md +++ b/.github/agents/team-validator.agent.md @@ -3,7 +3,7 @@ name: 'Team Validator' description: 'Quality gate — validates the complete team spec for consistency, conflicts, and completeness. Cross-references agents, teams, and commands to ensure everything is properly wired.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Quality gate — validates the complete team spec for consistency, conflicts, an ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -72,7 +72,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/test-lead.agent.md b/.github/agents/test-lead.agent.md index c2c77891..944b93b1 100644 --- a/.github/agents/test-lead.agent.md +++ b/.github/agents/test-lead.agent.md @@ -3,7 +3,7 @@ name: 'Test Lead' description: 'Test strategy lead responsible for overall test architecture, test planning, and quality gate definitions. Ensures comprehensive coverage across unit, integration, and end-to-end testing.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Test strategy lead responsible for overall test architecture, test planning, and ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -82,7 +82,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/token-efficiency-engineer.agent.md b/.github/agents/token-efficiency-engineer.agent.md index 3cbe7551..0bc67a13 100644 --- a/.github/agents/token-efficiency-engineer.agent.md +++ b/.github/agents/token-efficiency-engineer.agent.md @@ -3,7 +3,7 @@ name: 'Token Efficiency Engineer' description: 'Prompt engineering and token optimization specialist. Analyzes prompt templates, system instructions, and conversation patterns for token waste. Designs compact prompt structures, implements caching strategies (Anthropic prompt caching, OpenAI cached context), and optimizes request batching to reduce per-request overhead.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Prompt engineering and token optimization specialist. Analyzes prompt templates, ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -84,7 +84,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/ui-designer.agent.md b/.github/agents/ui-designer.agent.md index a02318a9..1aa38b5f 100644 --- a/.github/agents/ui-designer.agent.md +++ b/.github/agents/ui-designer.agent.md @@ -3,7 +3,7 @@ name: 'UI Designer' description: 'UI/UX design specialist responsible for interaction patterns, component design, layout systems, and visual hierarchy. Bridges design intent and implementation.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ UI/UX design specialist responsible for interaction patterns, component design, ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -78,7 +78,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/agents/vendor-arbitrage-analyst.agent.md b/.github/agents/vendor-arbitrage-analyst.agent.md index 8212f53d..b22d3084 100644 --- a/.github/agents/vendor-arbitrage-analyst.agent.md +++ b/.github/agents/vendor-arbitrage-analyst.agent.md @@ -3,7 +3,7 @@ name: 'Vendor Arbitrage Analyst' description: 'Multi-vendor cost arbitrage specialist. Maximizes free tiers, committed use discounts, spot/preemptible pricing, and time-based rate variations. Manages vendor credit programs, startup benefit packages, and negotiated enterprise agreements.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot agent definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- @@ -14,7 +14,7 @@ Multi-vendor cost arbitrage specialist. Maximizes free tiers, committed use disc ## Repository Context -- **Repository:** agentkit-forge +- **Repository:** retort - **Default branch:** main - **Primary context docs:** `CLAUDE.md`, `UNIFIED_AGENT_TEAMS.md`, `AGENT_TEAMS.md`, `AGENT_BACKLOG.md`, `docs/` - **Tech stack:** javascript, yaml, markdown @@ -83,7 +83,7 @@ Scan the codebase within your focus area before making changes. Read `UNIFIED_AG - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - Commit the spec change and regenerated outputs together - CI runs a drift check and will fail if generated files are out of sync diff --git a/.github/ai-framework-ci.yml b/.github/ai-framework-ci.yml index 2dc581e7..709e6435 100644 --- a/.github/ai-framework-ci.yml +++ b/.github/ai-framework-ci.yml @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync name: AI Framework Validation on: diff --git a/.github/chatmodes/team-backend.chatmode.md b/.github/chatmodes/team-backend.chatmode.md index a24771e5..6c70b7ef 100644 --- a/.github/chatmodes/team-backend.chatmode.md +++ b/.github/chatmodes/team-backend.chatmode.md @@ -3,14 +3,14 @@ name: 'BACKEND' description: 'Team BACKEND — API, services, core logic' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: BACKEND diff --git a/.github/chatmodes/team-cost-ops.chatmode.md b/.github/chatmodes/team-cost-ops.chatmode.md index a8107579..a96716ee 100644 --- a/.github/chatmodes/team-cost-ops.chatmode.md +++ b/.github/chatmodes/team-cost-ops.chatmode.md @@ -3,14 +3,14 @@ name: 'COST OPS' description: 'Team COST OPS — AI infrastructure cost reduction, vendor optimization, token efficiency' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: COST OPS diff --git a/.github/chatmodes/team-data.chatmode.md b/.github/chatmodes/team-data.chatmode.md index ee85b667..e8a9f458 100644 --- a/.github/chatmodes/team-data.chatmode.md +++ b/.github/chatmodes/team-data.chatmode.md @@ -3,14 +3,14 @@ name: 'DATA' description: 'Team DATA — Database, models, migrations' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: DATA diff --git a/.github/chatmodes/team-devops.chatmode.md b/.github/chatmodes/team-devops.chatmode.md index 51d85894..5fbf8498 100644 --- a/.github/chatmodes/team-devops.chatmode.md +++ b/.github/chatmodes/team-devops.chatmode.md @@ -3,14 +3,14 @@ name: 'DEVOPS' description: 'Team DEVOPS — CI/CD, pipelines, automation' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: DEVOPS diff --git a/.github/chatmodes/team-docs.chatmode.md b/.github/chatmodes/team-docs.chatmode.md index db832117..8d816fa2 100644 --- a/.github/chatmodes/team-docs.chatmode.md +++ b/.github/chatmodes/team-docs.chatmode.md @@ -3,14 +3,14 @@ name: 'DOCUMENTATION' description: 'Team DOCUMENTATION — Docs, ADRs, guides' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: DOCUMENTATION diff --git a/.github/chatmodes/team-forge.chatmode.md b/.github/chatmodes/team-forge.chatmode.md index 054ef88f..954631e4 100644 --- a/.github/chatmodes/team-forge.chatmode.md +++ b/.github/chatmodes/team-forge.chatmode.md @@ -3,14 +3,14 @@ name: 'TEAMFORGE' description: 'Team TEAMFORGE — Meta-team — creates, validates, and deploys new agent team specifications' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: TEAMFORGE diff --git a/.github/chatmodes/team-frontend.chatmode.md b/.github/chatmodes/team-frontend.chatmode.md index 4074c854..44fb94aa 100644 --- a/.github/chatmodes/team-frontend.chatmode.md +++ b/.github/chatmodes/team-frontend.chatmode.md @@ -3,14 +3,14 @@ name: 'FRONTEND' description: 'Team FRONTEND — UI, components, PWA' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: FRONTEND diff --git a/.github/chatmodes/team-infra.chatmode.md b/.github/chatmodes/team-infra.chatmode.md index 3a9c1ce5..e8dbc3df 100644 --- a/.github/chatmodes/team-infra.chatmode.md +++ b/.github/chatmodes/team-infra.chatmode.md @@ -3,14 +3,14 @@ name: 'INFRA' description: 'Team INFRA — IaC, cloud, Terraform/Bicep' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: INFRA diff --git a/.github/chatmodes/team-product.chatmode.md b/.github/chatmodes/team-product.chatmode.md index ef0d3572..69f996c3 100644 --- a/.github/chatmodes/team-product.chatmode.md +++ b/.github/chatmodes/team-product.chatmode.md @@ -3,14 +3,14 @@ name: 'PRODUCT' description: 'Team PRODUCT — Features, PRDs, roadmap' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: PRODUCT diff --git a/.github/chatmodes/team-quality.chatmode.md b/.github/chatmodes/team-quality.chatmode.md index 08dc8524..6d3d5a9f 100644 --- a/.github/chatmodes/team-quality.chatmode.md +++ b/.github/chatmodes/team-quality.chatmode.md @@ -3,14 +3,14 @@ name: 'QUALITY' description: 'Team QUALITY — Code review, refactoring, bugs, reliability, session retrospectives' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: QUALITY diff --git a/.github/chatmodes/team-security.chatmode.md b/.github/chatmodes/team-security.chatmode.md index 3bef1382..b8371c0c 100644 --- a/.github/chatmodes/team-security.chatmode.md +++ b/.github/chatmodes/team-security.chatmode.md @@ -3,14 +3,14 @@ name: 'SECURITY' description: 'Team SECURITY — Auth, compliance, audit' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: SECURITY diff --git a/.github/chatmodes/team-strategic-ops.chatmode.md b/.github/chatmodes/team-strategic-ops.chatmode.md index 88033587..d2ed6fbc 100644 --- a/.github/chatmodes/team-strategic-ops.chatmode.md +++ b/.github/chatmodes/team-strategic-ops.chatmode.md @@ -3,14 +3,14 @@ name: 'STRATEGIC OPS' description: 'Team STRATEGIC OPS — Cross-project coordination, framework governance, portfolio-level planning' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: STRATEGIC OPS diff --git a/.github/chatmodes/team-testing.chatmode.md b/.github/chatmodes/team-testing.chatmode.md index 9543e6ef..6d249a4b 100644 --- a/.github/chatmodes/team-testing.chatmode.md +++ b/.github/chatmodes/team-testing.chatmode.md @@ -3,14 +3,14 @@ name: 'TESTING' description: 'Team TESTING — Unit, E2E, integration tests' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot chat mode definition. # Docs: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-agents-in-vs-code --- - - - + + + # Team: TESTING diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 9b7c28dd..5c640d8c 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,13 +1,13 @@ - - - - + + + + # GitHub Copilot Instructions -You are assisting with a project managed by the AgentKit Forge framework. +You are assisting with a project managed by the Retort framework. Follow these instructions for all code generation, suggestions, and chat responses. ## Project Context @@ -66,7 +66,7 @@ understand team assignments, ownership boundaries, and escalation paths. (TypeScript strict mode, Rust's type system, Python type hints with mypy). - **Conventional Commits (MANDATORY)**: All commit messages AND PR titles must use the format `type(scope): description`. Types: feat, fix, docs, style, refactor, test, chore, ci, perf, build, revert. Do NOT use natural-language titles like "Plan: Something" or "Update files" — CI will reject them. - Branch strategy: github-flow. -- **Generated file sync**: After editing any file in `.agentkit/spec/`, run `pnpm -C .agentkit agentkit:sync` and commit the regenerated output. CI drift checks will fail otherwise. +- **Generated file sync**: After editing any file in `.agentkit/spec/`, run `pnpm -C .agentkit retort:sync` and commit the regenerated output. CI drift checks will fail otherwise. ## Authentication & Authorization diff --git a/.github/prompts/analyze-agents.prompt.md b/.github/prompts/analyze-agents.prompt.md index 485b7bef..2a73249c 100644 --- a/.github/prompts/analyze-agents.prompt.md +++ b/.github/prompts/analyze-agents.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Generates a comprehensive agent/team relationship matrix. Analyzes dependencies, notifications, handoffs, coverage gaps, bottlenecks, and consolidation opportunities across all teams and agents.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # analyze-agents @@ -18,7 +18,7 @@ Generates a comprehensive agent/team relationship matrix. Analyzes dependencies, ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/backlog.prompt.md b/.github/prompts/backlog.prompt.md index 6d69b498..05f431b8 100644 --- a/.github/prompts/backlog.prompt.md +++ b/.github/prompts/backlog.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Displays a consolidated backlog view from all sources (external tracker, discovery, healthcheck, code TODOs, review findings, manual entries). Supports filtering and multiple output formats for CLI and future UI consumption.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # backlog @@ -18,7 +18,7 @@ Displays a consolidated backlog view from all sources (external tracker, discove ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/brand.prompt.md b/.github/prompts/brand.prompt.md index 15305bf0..21540b71 100644 --- a/.github/prompts/brand.prompt.md +++ b/.github/prompts/brand.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Manage the project brand spec (brand.yaml) and editor theme. Supports validation, palette preview, theme mapping, contrast auditing, scaffolding, and regeneration of editor theme files.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # brand @@ -18,7 +18,7 @@ Manage the project brand spec (brand.yaml) and editor theme. Supports validation ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/build.prompt.md b/.github/prompts/build.prompt.md index 1786e6dc..330ef347 100644 --- a/.github/prompts/build.prompt.md +++ b/.github/prompts/build.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Builds the project using the detected tech stack's build command. Supports targeting specific packages in a monorepo or building the entire workspace.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # build @@ -55,7 +55,7 @@ Report: detected stack, scope, exact command, status (PASS/FAIL), duration, arti ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/check.prompt.md b/.github/prompts/check.prompt.md index 63e99ae2..b8fef89c 100644 --- a/.github/prompts/check.prompt.md +++ b/.github/prompts/check.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Runs all quality checks for the repository: type checking, linting, formatting validation, and test suites. Returns a unified pass/fail status with detailed breakdowns per check category.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # check @@ -47,7 +47,7 @@ Produce: Quality Gate Results table (Step | Status | Duration | Details), Overal ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/cost-centres.prompt.md b/.github/prompts/cost-centres.prompt.md index fae638de..cabb9a5b 100644 --- a/.github/prompts/cost-centres.prompt.md +++ b/.github/prompts/cost-centres.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Cost centre management for cloud infrastructure. Manages budget allocations, resource group mappings, tag compliance, and spend tracking. Requires a FinOps-enabled overlay (finops rule domain). For AI session cost tracking, use /cost instead.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # cost-centres @@ -18,7 +18,7 @@ Cost centre management for cloud infrastructure. Manages budget allocations, res ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/cost.prompt.md b/.github/prompts/cost.prompt.md index 6f129ab9..e57573c8 100644 --- a/.github/prompts/cost.prompt.md +++ b/.github/prompts/cost.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Session cost and usage tracking. Shows session summaries, lists recent sessions, and generates aggregate usage reports. Tracks session duration, commands run, and files modified via lifecycle hooks.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # cost @@ -40,7 +40,7 @@ Session cost and usage tracking. Shows session summaries, lists recent sessions, ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/deploy.prompt.md b/.github/prompts/deploy.prompt.md index cc5f6509..0c0bae74 100644 --- a/.github/prompts/deploy.prompt.md +++ b/.github/prompts/deploy.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Triggers a deployment pipeline or generates deployment artifacts. Validates pre-deployment checks (build, test, lint) before proceeding. Supports dry-run mode for safety.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # deploy @@ -61,7 +61,7 @@ Report: service, environment, platform, status, timeline, command output, post-d ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/discover.prompt.md b/.github/prompts/discover.prompt.md index 21a946bd..5616629d 100644 --- a/.github/prompts/discover.prompt.md +++ b/.github/prompts/discover.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Scans the repository to build a comprehensive understanding of the project structure, tech stacks in use, team boundaries, and architectural patterns. Outputs a structured discovery report used by other commands.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # discover @@ -43,7 +43,7 @@ Create or update `AGENT_TEAMS.md` with: Repository Profile (primary stack, build ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/doctor.prompt.md b/.github/prompts/doctor.prompt.md index 5f839a43..b6e88bdc 100644 --- a/.github/prompts/doctor.prompt.md +++ b/.github/prompts/doctor.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Runs AgentKit Forge diagnostics: spec validation, overlay sanity checks, template availability, project.yaml completeness hints, and suggested next actions for fixing setup issues.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # doctor @@ -32,7 +32,7 @@ Runs AgentKit Forge diagnostics: spec validation, overlay sanity checks, templat ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/document-history.prompt.md b/.github/prompts/document-history.prompt.md index e41fa755..f489c158 100644 --- a/.github/prompts/document-history.prompt.md +++ b/.github/prompts/document-history.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Creates a structured history document from templates for significant work completed in the current session. Supports bug fixes, features, implementations, and migrations. Auto-detects type and title from git history when invoked without arguments. Fills in all template sections with concrete details from session context.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # document-history @@ -18,7 +18,7 @@ Creates a structured history document from templates for significant work comple ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/expand.prompt.md b/.github/prompts/expand.prompt.md index 57ca56a8..415c415b 100644 --- a/.github/prompts/expand.prompt.md +++ b/.github/prompts/expand.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Runs the expansion analyzer to identify gaps, missing capabilities, undocumented decisions, and improvement opportunities in the codebase. Produces a ranked list of suggestions with rationale, impact scores, and effort estimates. Never creates tasks in analysis mode — all suggestions require explicit human approval. Use --save to persist suggestions to disk for later review.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # expand @@ -18,7 +18,7 @@ Runs the expansion analyzer to identify gaps, missing capabilities, undocumented ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/feature-configure.prompt.md b/.github/prompts/feature-configure.prompt.md index 5a5a29e7..acfb191f 100644 --- a/.github/prompts/feature-configure.prompt.md +++ b/.github/prompts/feature-configure.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Interactive feature configuration workflow. Walks through each feature category, explains what each feature provides, shows current status, and applies changes via the overlay settings.yaml. Triggers a sync after changes are applied.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # feature-configure @@ -18,7 +18,7 @@ Interactive feature configuration workflow. Walks through each feature category, ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/feature-flow.prompt.md b/.github/prompts/feature-flow.prompt.md index 3b7d1323..84bad51d 100644 --- a/.github/prompts/feature-flow.prompt.md +++ b/.github/prompts/feature-flow.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Traces a specific feature end-to-end through the kit: shows which spec files define it, which template vars it injects, which templates consume those vars, what generated output it produces, and what overlay settings control it. Use this to understand or debug a feature's behavior.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # feature-flow @@ -18,7 +18,7 @@ Traces a specific feature end-to-end through the kit: shows which spec files def ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/feature-review.prompt.md b/.github/prompts/feature-review.prompt.md index 0450d97c..c6bce77e 100644 --- a/.github/prompts/feature-review.prompt.md +++ b/.github/prompts/feature-review.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Reviews the current feature configuration for the repo. Analyzes which features are enabled/disabled, checks for misconfigured dependencies, identifies unused features (enabled but no matching code patterns), and recommends features to enable based on codebase analysis.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # feature-review @@ -18,7 +18,7 @@ Reviews the current feature configuration for the repo. Analyzes which features ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/format.prompt.md b/.github/prompts/format.prompt.md index 4d27ec42..fa89ef17 100644 --- a/.github/prompts/format.prompt.md +++ b/.github/prompts/format.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Formats code using the detected tech stack's formatter. Can target specific files, directories, or the entire workspace. Reports files that were changed.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # format @@ -52,7 +52,7 @@ Report: formatters run, scope, mode, files changed/needing formatting, summary c ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/import-issues.prompt.md b/.github/prompts/import-issues.prompt.md index 87bb85fb..3b086fcb 100644 --- a/.github/prompts/import-issues.prompt.md +++ b/.github/prompts/import-issues.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Imports issues from the configured external tracker (GitHub or Linear), normalizes fields to the canonical backlog schema, deduplicates against existing items, assigns teams via intake routing rules, and merges into AGENT_BACKLOG.md and .claude/state/backlog.json. Gated behind the process.intake.autoImport flag (can be overridden with --force).' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # import-issues @@ -18,7 +18,7 @@ Imports issues from the configured external tracker (GitHub or Linear), normaliz ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/infra-eval.prompt.md b/.github/prompts/infra-eval.prompt.md index 0e57e387..b23ad239 100644 --- a/.github/prompts/infra-eval.prompt.md +++ b/.github/prompts/infra-eval.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Risk-aware infrastructure and codebase evaluation against reliability, cost, and scale fitness. Scores eight weighted dimensions (0–5 each), enforces hard gates for critical safety properties, and produces a scored summary with narrative risk analysis. Designed for quarterly reassessment, pre-funding due diligence, and architectural decision support. Gated behind the evaluation.infraEval project.yaml flag.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # infra-eval @@ -18,7 +18,7 @@ Risk-aware infrastructure and codebase evaluation against reliability, cost, and ## Instructions -When invoked, follow the AgentKit Forge orchestration lifecycle: +When invoked, follow the Retort orchestration lifecycle: 1. **Understand** the request and any arguments provided 2. **Scan** relevant files to build context @@ -28,7 +28,7 @@ When invoked, follow the AgentKit Forge orchestration lifecycle: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/orchestrate.prompt.md b/.github/prompts/orchestrate.prompt.md index c6dcda97..1671c2c5 100644 --- a/.github/prompts/orchestrate.prompt.md +++ b/.github/prompts/orchestrate.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Top-level orchestration command. Assesses the current repository state, identifies work to be done, delegates to appropriate team agents, and synthesizes results. The primary entry point for multi-step workflows.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # orchestrate @@ -51,7 +51,7 @@ Produce a summary with: Actions Taken, Files Changed, Validation Commands, Updat ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/plan.prompt.md b/.github/prompts/plan.prompt.md index c428c025..dc522870 100644 --- a/.github/prompts/plan.prompt.md +++ b/.github/prompts/plan.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Creates a detailed implementation plan for a feature, bug fix, or refactoring task. Analyzes the codebase, identifies affected files and teams, estimates complexity, and produces a step-by-step plan with acceptance criteria.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # plan @@ -41,7 +41,7 @@ You are the **Planning Agent**. Produce detailed, structured implementation plan ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/preflight.prompt.md b/.github/prompts/preflight.prompt.md index 561568ee..52e9b6c0 100644 --- a/.github/prompts/preflight.prompt.md +++ b/.github/prompts/preflight.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Runs enhanced delivery checks before ship: quality gates, changelog, coverage delta, commit convention conformance, TODO/FIXME hygiene, and documentation updates for externally visible changes.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # preflight @@ -37,7 +37,7 @@ If `--range` is omitted, auto-detect via merge-base against the default branch. ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/project-status.prompt.md b/.github/prompts/project-status.prompt.md index f9022f55..85a42141 100644 --- a/.github/prompts/project-status.prompt.md +++ b/.github/prompts/project-status.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Unified PM dashboard that aggregates orchestrator state, backlog, task progress, risks, and delivery metrics into a markdown or JSON report. Provides at-a-glance visibility into project health across all teams.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # project-status @@ -116,7 +116,7 @@ Produce markdown (default) or JSON (with `--format json`) with these sections: ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/review.prompt.md b/.github/prompts/review.prompt.md index 6a5be01e..b64a4cd3 100644 --- a/.github/prompts/review.prompt.md +++ b/.github/prompts/review.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Performs a structured code review of staged changes, a specific PR, or a range of commits. Evaluates code quality, adherence to domain rules, security concerns, test coverage, and architectural alignment.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # review @@ -59,7 +59,7 @@ Produce: Summary, Required Changes (must fix, with file:line references), Sugges ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/scaffold.prompt.md b/.github/prompts/scaffold.prompt.md index 16bd8241..466fd953 100644 --- a/.github/prompts/scaffold.prompt.md +++ b/.github/prompts/scaffold.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Generates implementation skeletons aligned with project conventions. Supports endpoints, UI components, IaC modules, migrations, tests, and services. Uses project.yaml context and domain rules to prefill structure and guardrails.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # scaffold @@ -37,7 +37,7 @@ Generates implementation skeletons aligned with project conventions. Supports en ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/security.prompt.md b/.github/prompts/security.prompt.md index 0da7f94e..96c3a2b8 100644 --- a/.github/prompts/security.prompt.md +++ b/.github/prompts/security.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Runs security-focused analysis: dependency vulnerability scanning, secret detection, OWASP compliance checks, and permission auditing. Generates a security report with severity ratings.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # security @@ -61,7 +61,7 @@ Produce: Executive Summary, Risk Score, Findings by severity (with ID, file:line ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/start.prompt.md b/.github/prompts/start.prompt.md index cd51f905..120b84d2 100644 --- a/.github/prompts/start.prompt.md +++ b/.github/prompts/start.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'New user entry point. Detects repository state, shows contextual status, and guides users to the right command or team for their goal. Read-only — suggests commands but does not execute them.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # start @@ -110,7 +110,7 @@ This command is **read-only**. It reads state files for context detection but do ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/sync-backlog.prompt.md b/.github/prompts/sync-backlog.prompt.md index ee232835..b58ca1d1 100644 --- a/.github/prompts/sync-backlog.prompt.md +++ b/.github/prompts/sync-backlog.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Synchronizes the local backlog with the configured issue tracker (GitHub or Linear), maps findings to ownership teams, updates local tracking documents, and identifies stale or unassigned work items.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # sync-backlog @@ -58,7 +58,7 @@ Priorities: P0 (blocking), P1 (high — this session), P2 (medium), P3 (low — ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/sync.prompt.md b/.github/prompts/sync.prompt.md index 52095e3f..0773c232 100644 --- a/.github/prompts/sync.prompt.md +++ b/.github/prompts/sync.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Regenerates all AI tool configurations from the AgentKit Forge spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # sync @@ -62,7 +62,7 @@ This command requires shell access (Bash tool). On platforms with restricted too ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/test.prompt.md b/.github/prompts/test.prompt.md index 7b40958b..4f0b5d94 100644 --- a/.github/prompts/test.prompt.md +++ b/.github/prompts/test.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Runs the test suite using the detected tech stack's test command. Supports filtering by test file, pattern, or package. Reports pass/fail counts and coverage when available.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # test @@ -56,7 +56,7 @@ Report: framework, scope, exact command, summary table (Total/Passed/Failed/Skip ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/prompts/validate.prompt.md b/.github/prompts/validate.prompt.md index ed7d2fe4..4a3f3246 100644 --- a/.github/prompts/validate.prompt.md +++ b/.github/prompts/validate.prompt.md @@ -3,14 +3,14 @@ mode: 'agent' description: 'Validates generated outputs for correctness. Checks that all required directories, JSON files, command files, and hook scripts exist and are well-formed. Scans for forbidden patterns (hardcoded secrets) and verifies the settings.json hooks configuration.' generated_by: 'agentkit-forge' last_model: 'sync-engine' -last_updated: '2026-03-17' +last_updated: '2026-03-21' # Format: YAML frontmatter + Markdown body. Copilot reusable prompt. # Docs: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot --- - - - + + + # validate @@ -31,7 +31,7 @@ Report: per-check pass/fail with details, overall PASS/FAIL status, list of miss ## Project Context -- Repository: agentkit-forge +- Repository: retort - Default branch: main - Tech stack: javascript, yaml, markdown diff --git a/.github/scripts/README.md b/.github/scripts/README.md index 18256599..0d067a20 100644 --- a/.github/scripts/README.md +++ b/.github/scripts/README.md @@ -1,14 +1,11 @@ - - - - + # GitHub Scripts Run-once setup scripts for configuring GitHub repository settings after -adopting AgentKit Forge. +adopting Retort. ## Available Scripts @@ -57,13 +54,13 @@ Configures branch protection rules for `main` using the GitHub CLI. **When to run:** -Run once after initial `agentkit sync`. The script is idempotent — running +Run once after initial `retort sync`. The script is idempotent — running it again will overwrite existing protection rules with the standard config. ### resolve-merge Resolves merge conflicts automatically for generated/framework-managed files -using the AgentKit merge resolution matrix. Files requiring semantic understanding +using the Retort merge resolution matrix. Files requiring semantic understanding (engine source, spec files) are flagged for manual resolution. **What it does:** diff --git a/.github/scripts/resolve-merge.ps1 b/.github/scripts/resolve-merge.ps1 index d458f8fd..4c01c0b1 100644 --- a/.github/scripts/resolve-merge.ps1 +++ b/.github/scripts/resolve-merge.ps1 @@ -3,12 +3,12 @@ # Regenerate: pnpm -C .agentkit agentkit:sync # ============================================================================= # resolve-merge.ps1 — Apply standard merge conflict resolutions (Windows) -# GENERATED by AgentKit Forge v3.1.0 — regenerated on every sync +# GENERATED by Retort v3.1.0 — regenerated on every sync # ============================================================================= # Usage: .github\scripts\resolve-merge.ps1 [-Target dev] # # Merges origin/ into the current branch and auto-resolves -# generated/framework-managed files per the AgentKit merge resolution matrix. +# generated/framework-managed files per the Retort merge resolution matrix. # Remaining conflicts (engine source, spec files) are listed for manual review. # ============================================================================= param( diff --git a/.github/scripts/resolve-merge.sh b/.github/scripts/resolve-merge.sh index 6f400e0d..ab372cdd 100755 --- a/.github/scripts/resolve-merge.sh +++ b/.github/scripts/resolve-merge.sh @@ -4,12 +4,12 @@ # Regenerate: pnpm -C .agentkit agentkit:sync # ============================================================================= # resolve-merge.sh — Apply standard merge conflict resolutions -# GENERATED by AgentKit Forge v3.1.0 — regenerated on every sync +# GENERATED by Retort v3.1.0 — regenerated on every sync # ============================================================================= # Usage: .github/scripts/resolve-merge.sh [target-branch] # # Merges origin/ into the current branch and auto-resolves -# generated/framework-managed files per the AgentKit merge resolution matrix. +# generated/framework-managed files per the Retort merge resolution matrix. # Remaining conflicts (engine source, spec files) are listed for manual review. # ============================================================================= set -euo pipefail diff --git a/.github/scripts/setup-branch-protection.ps1 b/.github/scripts/setup-branch-protection.ps1 index b371e340..2150830b 100644 --- a/.github/scripts/setup-branch-protection.ps1 +++ b/.github/scripts/setup-branch-protection.ps1 @@ -1,11 +1,11 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # setup-branch-protection.ps1 # Configures GitHub branch protection rules, repository settings, code # scanning rulesets, and Copilot review for the default branch. -# Generated by AgentKit Forge — run once after initial setup. +# Generated by Retort — run once after initial setup. # # Prerequisites: # - gh CLI installed and authenticated (gh auth status) @@ -61,7 +61,7 @@ if (-not $Repo) { exit 1 } -Write-Host "=== AgentKit Forge - Branch Protection Setup ===" +Write-Host "=== Retort - Branch Protection Setup ===" Write-Host "" Write-Host "Repository: $Repo" Write-Host "Branch: $Branch" @@ -247,7 +247,7 @@ if ($DryRun) { } } - New-LabelIfMissing "forge-source-change" "d93f0b" "PR modifies AgentKit Forge source files" + New-LabelIfMissing "forge-source-change" "d93f0b" "PR modifies Retort source files" New-LabelIfMissing "needs-maintainer-review" "e4e669" "Requires maintainer review before merge" New-LabelIfMissing "dependencies" "0075ca" "Dependency updates" New-LabelIfMissing "breaking-change" "b60205" "Contains breaking changes" diff --git a/.github/scripts/setup-branch-protection.sh b/.github/scripts/setup-branch-protection.sh index 4f7ae845..f4da9911 100755 --- a/.github/scripts/setup-branch-protection.sh +++ b/.github/scripts/setup-branch-protection.sh @@ -1,12 +1,12 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # --------------------------------------------------------------------------- # setup-branch-protection.sh # Configures GitHub branch protection rules, repository settings, code # scanning rulesets, and Copilot review for the default branch. -# Generated by AgentKit Forge — run once after initial setup. +# Generated by Retort — run once after initial setup. # # Prerequisites: # - gh CLI installed and authenticated (gh auth status) @@ -66,7 +66,7 @@ if [[ -z "$REPO" ]]; then exit 1 fi -echo "=== AgentKit Forge — Branch Protection Setup ===" +echo "=== Retort — Branch Protection Setup ===" echo "" echo "Repository: $REPO" echo "Branch: $BRANCH" @@ -264,7 +264,7 @@ else fi } - create_label_if_missing "forge-source-change" "d93f0b" "PR modifies AgentKit Forge source files" + create_label_if_missing "forge-source-change" "d93f0b" "PR modifies Retort source files" create_label_if_missing "needs-maintainer-review" "e4e669" "Requires maintainer review before merge" create_label_if_missing "dependencies" "0075ca" "Dependency updates" create_label_if_missing "breaking-change" "b60205" "Contains breaking changes" diff --git a/.github/workflows/breaking-change-detection.yml b/.github/workflows/breaking-change-detection.yml index 1192b9d0..a9eedf3c 100644 --- a/.github/workflows/breaking-change-detection.yml +++ b/.github/workflows/breaking-change-detection.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Detects potential breaking changes in PRs by analyzing version files, # changelogs, public API surfaces, and export maps. Non-blocking — reports diff --git a/.github/workflows/coverage-report.yml b/.github/workflows/coverage-report.yml index 77afd5ab..c6ca5a83 100644 --- a/.github/workflows/coverage-report.yml +++ b/.github/workflows/coverage-report.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Collects code coverage from test runs and reports regressions on PRs. # Non-blocking (continue-on-error). Threshold defaults to 80% diff --git a/.github/workflows/dependency-audit.yml b/.github/workflows/dependency-audit.yml index 89461b35..97b15a43 100644 --- a/.github/workflows/dependency-audit.yml +++ b/.github/workflows/dependency-audit.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Non-blocking dependency audit. Runs when lockfiles or manifests change. # Reports vulnerabilities and license issues as annotations — MUST NOT be diff --git a/.github/workflows/documentation-quality.yml b/.github/workflows/documentation-quality.yml index 722f37d4..00fb89ef 100644 --- a/.github/workflows/documentation-quality.yml +++ b/.github/workflows/documentation-quality.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Lints and validates documentation quality for history records. # Required on main (hard error). Warning-only on dev (surfaces issues without blocking). diff --git a/.github/workflows/documentation-validation.yml b/.github/workflows/documentation-validation.yml index 9918c180..621aba90 100644 --- a/.github/workflows/documentation-validation.yml +++ b/.github/workflows/documentation-validation.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Validates documentation requirements and structure on pull requests. # Required on main (hard error). Warning-only on dev (surfaces issues without blocking). diff --git a/.github/workflows/pr-validation.yml b/.github/workflows/pr-validation.yml index 0f37bb61..7e827088 100644 --- a/.github/workflows/pr-validation.yml +++ b/.github/workflows/pr-validation.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Validates PR changes: Terraform formatting, shell script linting, and # YAML syntax. Non-blocking for most checks — surfaces issues as annotations. diff --git a/.github/workflows/retrospective-quality.yml b/.github/workflows/retrospective-quality.yml index 3d288da4..81af1554 100644 --- a/.github/workflows/retrospective-quality.yml +++ b/.github/workflows/retrospective-quality.yml @@ -1,9 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync -# GENERATED by AgentKit Forge v3.1.0 — DO NOT EDIT -# Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # # Non-blocking CI job that validates retrospective records (issues and lessons). # This workflow is informational — it MUST NOT be added to branch protection diff --git a/.gitmessage b/.gitmessage index 81ffc7af..e3ec500f 100644 --- a/.gitmessage +++ b/.gitmessage @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # (): # # Types: feat | fix | refactor | perf | docs | style | test | chore | ci | security diff --git a/.roo/rules/agent-conduct.md b/.roo/rules/agent-conduct.md index 80cd7fbd..3e762ecb 100644 --- a/.roo/rules/agent-conduct.md +++ b/.roo/rules/agent-conduct.md @@ -1,4 +1,4 @@ - + diff --git a/.roo/rules/ai-cost-ops.md b/.roo/rules/ai-cost-ops.md index 2df7b6f0..c7ae30e0 100644 --- a/.roo/rules/ai-cost-ops.md +++ b/.roo/rules/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/blockchain.md b/.roo/rules/blockchain.md index 19987be8..89edbbb4 100644 --- a/.roo/rules/blockchain.md +++ b/.roo/rules/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/ci-cd.md b/.roo/rules/ci-cd.md index 74defc4c..cd4c5195 100644 --- a/.roo/rules/ci-cd.md +++ b/.roo/rules/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/dependency-management.md b/.roo/rules/dependency-management.md index a7ab6192..c0f1a2db 100644 --- a/.roo/rules/dependency-management.md +++ b/.roo/rules/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/documentation.md b/.roo/rules/documentation.md index e5f4f47f..c2da131a 100644 --- a/.roo/rules/documentation.md +++ b/.roo/rules/documentation.md @@ -1,4 +1,4 @@ - + diff --git a/.roo/rules/dotnet.md b/.roo/rules/dotnet.md index 8b7962e6..9e50d131 100644 --- a/.roo/rules/dotnet.md +++ b/.roo/rules/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/finops.md b/.roo/rules/finops.md index 22e469f9..5c1f932e 100644 --- a/.roo/rules/finops.md +++ b/.roo/rules/finops.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/git-workflow.md b/.roo/rules/git-workflow.md index a252f07f..504f92cc 100644 --- a/.roo/rules/git-workflow.md +++ b/.roo/rules/git-workflow.md @@ -1,4 +1,4 @@ - + diff --git a/.roo/rules/iac.md b/.roo/rules/iac.md index 39e0d4ed..c568ff96 100644 --- a/.roo/rules/iac.md +++ b/.roo/rules/iac.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/languages/README.md b/.roo/rules/languages/README.md index afe5855e..531f558b 100644 --- a/.roo/rules/languages/README.md +++ b/.roo/rules/languages/README.md @@ -1,7 +1,7 @@ - - - - + + + + # Language-Specific Instructions @@ -10,7 +10,7 @@ This directory contains instruction files for **agentkit-forge**, one per rule domain defined in `.agentkit/spec/rules.yaml`. Each file provides language-specific coding conventions, testing patterns, and tooling requirements. -These files are generated by AgentKit Forge and deployed to each configured AI +These files are generated by Retort and deployed to each configured AI platform: | Platform | Output location | @@ -29,7 +29,7 @@ platform: ## How It Works -For each rule domain, AgentKit Forge renders a Markdown file using the +For each rule domain, Retort renders a Markdown file using the following template priority: 1. **Platform overlay** — `/language-instructions/.md` diff --git a/.roo/rules/languages/agent-conduct.md b/.roo/rules/languages/agent-conduct.md index dbc10857..09749ba5 100644 --- a/.roo/rules/languages/agent-conduct.md +++ b/.roo/rules/languages/agent-conduct.md @@ -1,4 +1,4 @@ - + # Instructions — agent-conduct diff --git a/.roo/rules/languages/ai-cost-ops.md b/.roo/rules/languages/ai-cost-ops.md index d924c4f4..29bc2a3d 100644 --- a/.roo/rules/languages/ai-cost-ops.md +++ b/.roo/rules/languages/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ai-cost-ops diff --git a/.roo/rules/languages/blockchain.md b/.roo/rules/languages/blockchain.md index 033a47be..6dbf76e3 100644 --- a/.roo/rules/languages/blockchain.md +++ b/.roo/rules/languages/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Blockchain / Smart Contracts diff --git a/.roo/rules/languages/ci-cd.md b/.roo/rules/languages/ci-cd.md index 501f6b92..5a51259d 100644 --- a/.roo/rules/languages/ci-cd.md +++ b/.roo/rules/languages/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ci-cd diff --git a/.roo/rules/languages/dependency-management.md b/.roo/rules/languages/dependency-management.md index 3447a4f0..a1e223e8 100644 --- a/.roo/rules/languages/dependency-management.md +++ b/.roo/rules/languages/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — dependency-management diff --git a/.roo/rules/languages/documentation.md b/.roo/rules/languages/documentation.md index 1f17dee9..ad2b59cc 100644 --- a/.roo/rules/languages/documentation.md +++ b/.roo/rules/languages/documentation.md @@ -1,4 +1,4 @@ - + # Instructions — documentation diff --git a/.roo/rules/languages/dotnet.md b/.roo/rules/languages/dotnet.md index 28cdeb94..a0b143fa 100644 --- a/.roo/rules/languages/dotnet.md +++ b/.roo/rules/languages/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — .NET / C# diff --git a/.roo/rules/languages/finops.md b/.roo/rules/languages/finops.md index caeb856c..34e716e2 100644 --- a/.roo/rules/languages/finops.md +++ b/.roo/rules/languages/finops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — finops diff --git a/.roo/rules/languages/git-workflow.md b/.roo/rules/languages/git-workflow.md index c0ffc0ff..188f6636 100644 --- a/.roo/rules/languages/git-workflow.md +++ b/.roo/rules/languages/git-workflow.md @@ -1,4 +1,4 @@ - + # Instructions — git-workflow diff --git a/.roo/rules/languages/iac.md b/.roo/rules/languages/iac.md index 9a60811c..4d5275be 100644 --- a/.roo/rules/languages/iac.md +++ b/.roo/rules/languages/iac.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Infrastructure as Code diff --git a/.roo/rules/languages/python.md b/.roo/rules/languages/python.md index 4b32df79..e306fb2d 100644 --- a/.roo/rules/languages/python.md +++ b/.roo/rules/languages/python.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Python diff --git a/.roo/rules/languages/rust.md b/.roo/rules/languages/rust.md index 449fe7d0..5bce7d63 100644 --- a/.roo/rules/languages/rust.md +++ b/.roo/rules/languages/rust.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Rust diff --git a/.roo/rules/languages/security.md b/.roo/rules/languages/security.md index 9f21e175..17c37314 100644 --- a/.roo/rules/languages/security.md +++ b/.roo/rules/languages/security.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — security diff --git a/.roo/rules/languages/template-protection.md b/.roo/rules/languages/template-protection.md index f7acfee9..78f276ce 100644 --- a/.roo/rules/languages/template-protection.md +++ b/.roo/rules/languages/template-protection.md @@ -1,4 +1,4 @@ - + # Instructions — template-protection diff --git a/.roo/rules/languages/testing.md b/.roo/rules/languages/testing.md index 64fe69b3..585420e0 100644 --- a/.roo/rules/languages/testing.md +++ b/.roo/rules/languages/testing.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — testing diff --git a/.roo/rules/languages/typescript.md b/.roo/rules/languages/typescript.md index feba3f0b..71a6101e 100644 --- a/.roo/rules/languages/typescript.md +++ b/.roo/rules/languages/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — TypeScript / JavaScript diff --git a/.roo/rules/python.md b/.roo/rules/python.md index fb151779..8e873029 100644 --- a/.roo/rules/python.md +++ b/.roo/rules/python.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/rust.md b/.roo/rules/rust.md index e90cd852..af1f9b74 100644 --- a/.roo/rules/rust.md +++ b/.roo/rules/rust.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/security.md b/.roo/rules/security.md index f54bc626..0cfc1ec9 100644 --- a/.roo/rules/security.md +++ b/.roo/rules/security.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/template-protection.md b/.roo/rules/template-protection.md index 09309995..e92ec100 100644 --- a/.roo/rules/template-protection.md +++ b/.roo/rules/template-protection.md @@ -1,4 +1,4 @@ - + diff --git a/.roo/rules/testing.md b/.roo/rules/testing.md index 44abd5d2..6360e6f7 100644 --- a/.roo/rules/testing.md +++ b/.roo/rules/testing.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.roo/rules/typescript.md b/.roo/rules/typescript.md index 5a16c285..4290c0c9 100644 --- a/.roo/rules/typescript.md +++ b/.roo/rules/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/analyze-agents.md b/.windsurf/commands/analyze-agents.md index 62f60158..9d0cd19a 100644 --- a/.windsurf/commands/analyze-agents.md +++ b/.windsurf/commands/analyze-agents.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/backlog.md b/.windsurf/commands/backlog.md index 9e55aea9..02a3dd0b 100644 --- a/.windsurf/commands/backlog.md +++ b/.windsurf/commands/backlog.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/brand.md b/.windsurf/commands/brand.md index a0bd9860..ac9a7d53 100644 --- a/.windsurf/commands/brand.md +++ b/.windsurf/commands/brand.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/build.md b/.windsurf/commands/build.md index b12e6295..c30ffe23 100644 --- a/.windsurf/commands/build.md +++ b/.windsurf/commands/build.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/check.md b/.windsurf/commands/check.md index 04e9f8e3..1f83e1af 100644 --- a/.windsurf/commands/check.md +++ b/.windsurf/commands/check.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/cost-centres.md b/.windsurf/commands/cost-centres.md index 66f6a670..92cc7df9 100644 --- a/.windsurf/commands/cost-centres.md +++ b/.windsurf/commands/cost-centres.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/cost.md b/.windsurf/commands/cost.md index 82553b29..9391a9c5 100644 --- a/.windsurf/commands/cost.md +++ b/.windsurf/commands/cost.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/deploy.md b/.windsurf/commands/deploy.md index c4ed002b..1c2c094d 100644 --- a/.windsurf/commands/deploy.md +++ b/.windsurf/commands/deploy.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/discover.md b/.windsurf/commands/discover.md index 143b69f4..1e766ff3 100644 --- a/.windsurf/commands/discover.md +++ b/.windsurf/commands/discover.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/doctor.md b/.windsurf/commands/doctor.md index fe1ec482..313b5a56 100644 --- a/.windsurf/commands/doctor.md +++ b/.windsurf/commands/doctor.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/document-history.md b/.windsurf/commands/document-history.md index 3e598f1a..11444d51 100644 --- a/.windsurf/commands/document-history.md +++ b/.windsurf/commands/document-history.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/expand.md b/.windsurf/commands/expand.md index c82fa123..fc4733e9 100644 --- a/.windsurf/commands/expand.md +++ b/.windsurf/commands/expand.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/feature-configure.md b/.windsurf/commands/feature-configure.md index 56bc4333..8f2a4c19 100644 --- a/.windsurf/commands/feature-configure.md +++ b/.windsurf/commands/feature-configure.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/feature-flow.md b/.windsurf/commands/feature-flow.md index 311f3fe8..3ddef949 100644 --- a/.windsurf/commands/feature-flow.md +++ b/.windsurf/commands/feature-flow.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/feature-review.md b/.windsurf/commands/feature-review.md index 0c50f0a4..0d9359fa 100644 --- a/.windsurf/commands/feature-review.md +++ b/.windsurf/commands/feature-review.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/format.md b/.windsurf/commands/format.md index c4c1ea3f..87cc4987 100644 --- a/.windsurf/commands/format.md +++ b/.windsurf/commands/format.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/import-issues.md b/.windsurf/commands/import-issues.md index 04b67402..65a8d81e 100644 --- a/.windsurf/commands/import-issues.md +++ b/.windsurf/commands/import-issues.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/infra-eval.md b/.windsurf/commands/infra-eval.md index 36bef760..d1470b3a 100644 --- a/.windsurf/commands/infra-eval.md +++ b/.windsurf/commands/infra-eval.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/orchestrate.md b/.windsurf/commands/orchestrate.md index 87f0e1df..5ae878c8 100644 --- a/.windsurf/commands/orchestrate.md +++ b/.windsurf/commands/orchestrate.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/plan.md b/.windsurf/commands/plan.md index 4475c42d..b12ec08f 100644 --- a/.windsurf/commands/plan.md +++ b/.windsurf/commands/plan.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/preflight.md b/.windsurf/commands/preflight.md index 19794261..115e9652 100644 --- a/.windsurf/commands/preflight.md +++ b/.windsurf/commands/preflight.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/project-status.md b/.windsurf/commands/project-status.md index fa4c576c..89071ef5 100644 --- a/.windsurf/commands/project-status.md +++ b/.windsurf/commands/project-status.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/review.md b/.windsurf/commands/review.md index 754ec92b..7b4f82b5 100644 --- a/.windsurf/commands/review.md +++ b/.windsurf/commands/review.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/scaffold.md b/.windsurf/commands/scaffold.md index 8993e1e6..aa17e2dd 100644 --- a/.windsurf/commands/scaffold.md +++ b/.windsurf/commands/scaffold.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/security.md b/.windsurf/commands/security.md index c3008b86..f44b8fda 100644 --- a/.windsurf/commands/security.md +++ b/.windsurf/commands/security.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/start.md b/.windsurf/commands/start.md index dd8b8527..a6ffd85c 100644 --- a/.windsurf/commands/start.md +++ b/.windsurf/commands/start.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/sync-backlog.md b/.windsurf/commands/sync-backlog.md index bb7c2692..c43e17c2 100644 --- a/.windsurf/commands/sync-backlog.md +++ b/.windsurf/commands/sync-backlog.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/sync.md b/.windsurf/commands/sync.md index 7eb5c834..d750720e 100644 --- a/.windsurf/commands/sync.md +++ b/.windsurf/commands/sync.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/test.md b/.windsurf/commands/test.md index 4cba6bdb..8bd9c190 100644 --- a/.windsurf/commands/test.md +++ b/.windsurf/commands/test.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/commands/validate.md b/.windsurf/commands/validate.md index 8dddbc0c..a7a65541 100644 --- a/.windsurf/commands/validate.md +++ b/.windsurf/commands/validate.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/rules/languages/README.md b/.windsurf/rules/languages/README.md index afe5855e..531f558b 100644 --- a/.windsurf/rules/languages/README.md +++ b/.windsurf/rules/languages/README.md @@ -1,7 +1,7 @@ - - - - + + + + # Language-Specific Instructions @@ -10,7 +10,7 @@ This directory contains instruction files for **agentkit-forge**, one per rule domain defined in `.agentkit/spec/rules.yaml`. Each file provides language-specific coding conventions, testing patterns, and tooling requirements. -These files are generated by AgentKit Forge and deployed to each configured AI +These files are generated by Retort and deployed to each configured AI platform: | Platform | Output location | @@ -29,7 +29,7 @@ platform: ## How It Works -For each rule domain, AgentKit Forge renders a Markdown file using the +For each rule domain, Retort renders a Markdown file using the following template priority: 1. **Platform overlay** — `/language-instructions/.md` diff --git a/.windsurf/rules/languages/agent-conduct.md b/.windsurf/rules/languages/agent-conduct.md index dbc10857..09749ba5 100644 --- a/.windsurf/rules/languages/agent-conduct.md +++ b/.windsurf/rules/languages/agent-conduct.md @@ -1,4 +1,4 @@ - + # Instructions — agent-conduct diff --git a/.windsurf/rules/languages/ai-cost-ops.md b/.windsurf/rules/languages/ai-cost-ops.md index d924c4f4..29bc2a3d 100644 --- a/.windsurf/rules/languages/ai-cost-ops.md +++ b/.windsurf/rules/languages/ai-cost-ops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ai-cost-ops diff --git a/.windsurf/rules/languages/blockchain.md b/.windsurf/rules/languages/blockchain.md index 033a47be..6dbf76e3 100644 --- a/.windsurf/rules/languages/blockchain.md +++ b/.windsurf/rules/languages/blockchain.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Blockchain / Smart Contracts diff --git a/.windsurf/rules/languages/ci-cd.md b/.windsurf/rules/languages/ci-cd.md index 501f6b92..5a51259d 100644 --- a/.windsurf/rules/languages/ci-cd.md +++ b/.windsurf/rules/languages/ci-cd.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — ci-cd diff --git a/.windsurf/rules/languages/dependency-management.md b/.windsurf/rules/languages/dependency-management.md index 3447a4f0..a1e223e8 100644 --- a/.windsurf/rules/languages/dependency-management.md +++ b/.windsurf/rules/languages/dependency-management.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — dependency-management diff --git a/.windsurf/rules/languages/documentation.md b/.windsurf/rules/languages/documentation.md index 1f17dee9..ad2b59cc 100644 --- a/.windsurf/rules/languages/documentation.md +++ b/.windsurf/rules/languages/documentation.md @@ -1,4 +1,4 @@ - + # Instructions — documentation diff --git a/.windsurf/rules/languages/dotnet.md b/.windsurf/rules/languages/dotnet.md index 28cdeb94..a0b143fa 100644 --- a/.windsurf/rules/languages/dotnet.md +++ b/.windsurf/rules/languages/dotnet.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — .NET / C# diff --git a/.windsurf/rules/languages/finops.md b/.windsurf/rules/languages/finops.md index caeb856c..34e716e2 100644 --- a/.windsurf/rules/languages/finops.md +++ b/.windsurf/rules/languages/finops.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — finops diff --git a/.windsurf/rules/languages/git-workflow.md b/.windsurf/rules/languages/git-workflow.md index c0ffc0ff..188f6636 100644 --- a/.windsurf/rules/languages/git-workflow.md +++ b/.windsurf/rules/languages/git-workflow.md @@ -1,4 +1,4 @@ - + # Instructions — git-workflow diff --git a/.windsurf/rules/languages/iac.md b/.windsurf/rules/languages/iac.md index 9a60811c..4d5275be 100644 --- a/.windsurf/rules/languages/iac.md +++ b/.windsurf/rules/languages/iac.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Infrastructure as Code diff --git a/.windsurf/rules/languages/python.md b/.windsurf/rules/languages/python.md index 4b32df79..e306fb2d 100644 --- a/.windsurf/rules/languages/python.md +++ b/.windsurf/rules/languages/python.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Python diff --git a/.windsurf/rules/languages/rust.md b/.windsurf/rules/languages/rust.md index 449fe7d0..5bce7d63 100644 --- a/.windsurf/rules/languages/rust.md +++ b/.windsurf/rules/languages/rust.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — Rust diff --git a/.windsurf/rules/languages/security.md b/.windsurf/rules/languages/security.md index 9f21e175..17c37314 100644 --- a/.windsurf/rules/languages/security.md +++ b/.windsurf/rules/languages/security.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — security diff --git a/.windsurf/rules/languages/template-protection.md b/.windsurf/rules/languages/template-protection.md index f7acfee9..78f276ce 100644 --- a/.windsurf/rules/languages/template-protection.md +++ b/.windsurf/rules/languages/template-protection.md @@ -1,4 +1,4 @@ - + # Instructions — template-protection diff --git a/.windsurf/rules/languages/testing.md b/.windsurf/rules/languages/testing.md index 64fe69b3..585420e0 100644 --- a/.windsurf/rules/languages/testing.md +++ b/.windsurf/rules/languages/testing.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — testing diff --git a/.windsurf/rules/languages/typescript.md b/.windsurf/rules/languages/typescript.md index feba3f0b..71a6101e 100644 --- a/.windsurf/rules/languages/typescript.md +++ b/.windsurf/rules/languages/typescript.md @@ -1,7 +1,7 @@ - - - - + + + + # Instructions — TypeScript / JavaScript diff --git a/.windsurf/rules/orchestrate.md b/.windsurf/rules/orchestrate.md index 196d5564..0f60acd6 100644 --- a/.windsurf/rules/orchestrate.md +++ b/.windsurf/rules/orchestrate.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/rules/project.md b/.windsurf/rules/project.md index bafbddf8..f586732b 100644 --- a/.windsurf/rules/project.md +++ b/.windsurf/rules/project.md @@ -1,10 +1,10 @@ - + # Project Context -This repository uses the AgentKit Forge unified agent team framework. +This repository uses the Retort unified agent team framework. ## Language Profile Diagnostics @@ -53,4 +53,4 @@ This repository uses the AgentKit Forge unified agent team framework. - Reference UNIFIED_AGENT_TEAMS.md for team assignments and escalation paths - PR titles must use Conventional Commits format: `type(scope): description` — CI rejects non-conforming titles - Breaking changes (`!:` or `BREAKING` in PR title) require a `## Breaking Changes` section in the PR body -- Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT` — modify `.agentkit/spec/` and run sync +- Never edit files marked `GENERATED by Retort — DO NOT EDIT` — modify `.agentkit/spec/` and run sync diff --git a/.windsurf/rules/security.md b/.windsurf/rules/security.md index 650d859c..2318f262 100644 --- a/.windsurf/rules/security.md +++ b/.windsurf/rules/security.md @@ -1,7 +1,7 @@ - - - - + + + + diff --git a/.windsurf/rules/team-backend.md b/.windsurf/rules/team-backend.md index 0586ca18..3df4ec28 100644 --- a/.windsurf/rules/team-backend.md +++ b/.windsurf/rules/team-backend.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-cost-ops.md b/.windsurf/rules/team-cost-ops.md index 4347fe7b..0602d76b 100644 --- a/.windsurf/rules/team-cost-ops.md +++ b/.windsurf/rules/team-cost-ops.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-data.md b/.windsurf/rules/team-data.md index 616deda2..e2e3cde9 100644 --- a/.windsurf/rules/team-data.md +++ b/.windsurf/rules/team-data.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-devops.md b/.windsurf/rules/team-devops.md index 26808688..2fa994d9 100644 --- a/.windsurf/rules/team-devops.md +++ b/.windsurf/rules/team-devops.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-docs.md b/.windsurf/rules/team-docs.md index 72fc3665..f72ac070 100644 --- a/.windsurf/rules/team-docs.md +++ b/.windsurf/rules/team-docs.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-forge.md b/.windsurf/rules/team-forge.md index caa0068f..70646c2b 100644 --- a/.windsurf/rules/team-forge.md +++ b/.windsurf/rules/team-forge.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-frontend.md b/.windsurf/rules/team-frontend.md index d5475fa7..5bfc81d4 100644 --- a/.windsurf/rules/team-frontend.md +++ b/.windsurf/rules/team-frontend.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-infra.md b/.windsurf/rules/team-infra.md index cb9a77df..5b7bb122 100644 --- a/.windsurf/rules/team-infra.md +++ b/.windsurf/rules/team-infra.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-product.md b/.windsurf/rules/team-product.md index ac9a2f58..74bf1604 100644 --- a/.windsurf/rules/team-product.md +++ b/.windsurf/rules/team-product.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-quality.md b/.windsurf/rules/team-quality.md index 0ef26c9c..467218cc 100644 --- a/.windsurf/rules/team-quality.md +++ b/.windsurf/rules/team-quality.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-security.md b/.windsurf/rules/team-security.md index 4b4f2472..18f780ae 100644 --- a/.windsurf/rules/team-security.md +++ b/.windsurf/rules/team-security.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-strategic-ops.md b/.windsurf/rules/team-strategic-ops.md index 26e80def..78bcf6b0 100644 --- a/.windsurf/rules/team-strategic-ops.md +++ b/.windsurf/rules/team-strategic-ops.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/rules/team-testing.md b/.windsurf/rules/team-testing.md index 87831a7c..f1d8ed29 100644 --- a/.windsurf/rules/team-testing.md +++ b/.windsurf/rules/team-testing.md @@ -1,4 +1,4 @@ - + @@ -19,6 +19,6 @@ Scope all operations to the team's owned paths. - CI enforces this — non-conforming titles will block merge - **Commit messages** must also follow Conventional Commits - **Breaking changes** (`!:` in title or `BREAKING` keyword) require a `## Breaking Changes` section, ADR reference, or migration guide in the PR body — CI checks for this -- **Never edit files marked `GENERATED by AgentKit Forge — DO NOT EDIT`** - - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit agentkit:sync` +- **Never edit files marked `GENERATED by Retort — DO NOT EDIT`** + - Modify the source spec in `.agentkit/spec/` and run `pnpm -C .agentkit retort:sync` - CI runs a drift check and will fail if generated files are out of sync diff --git a/.windsurf/workflows/full-assessment.yml b/.windsurf/workflows/full-assessment.yml index 1392da29..1d32d46e 100644 --- a/.windsurf/workflows/full-assessment.yml +++ b/.windsurf/workflows/full-assessment.yml @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync name: full-assessment description: 'Run complete codebase assessment' steps: diff --git a/.windsurf/workflows/phase-execution.yml b/.windsurf/workflows/phase-execution.yml index 9e578027..510920e1 100644 --- a/.windsurf/workflows/phase-execution.yml +++ b/.windsurf/workflows/phase-execution.yml @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync name: phase-execution description: 'Execute a specific workflow phase' inputs: diff --git a/AGENTS.md b/AGENTS.md index 676d68ee..a8533f99 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,9 +1,9 @@ - + # retort -Retort framework for multi-tool AI agent team orchestration, sync generation, and quality-gated workflows. +AgentKit Forge framework for multi-tool AI agent team orchestration, sync generation, and quality-gated workflows. ## Project Context diff --git a/AGENT_TEAMS.md b/AGENT_TEAMS.md index a3af0062..64b079cd 100644 --- a/AGENT_TEAMS.md +++ b/AGENT_TEAMS.md @@ -1,9 +1,32 @@ + +<<<<<<< YOUR_EDITS + +<<<<<<< YOUR_EDITS + +# Agent Teams — agentkit-forge + +||||||| LAST_SYNC + +# Agent Teams — agentkit-forge + +======= + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Agent Teams — retort +> > > > > > > NEW_TEMPLATE + > Repo-local team mapping derived from `.agentkit/spec/teams.yaml`. > Customize the **Status**, **Primary Scope**, **Tech Stack**, and **Lead Agent** > columns for your repository. The orchestrator uses this file for task dispatch. diff --git a/CLAUDE.md b/CLAUDE.md index 2ed75485..9fc13d31 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,17 +1,18 @@ - + -# agentkit-forge — Claude Code Instructions +# retort — Claude Code Instructions ## Project Overview AgentKit Forge framework for multi-tool AI agent team orchestration, sync generation, and quality-gated workflows. -This repository uses **AgentKit Forge** to manage AI agent team workflows across multiple tools. +This repository uses **Retort** to manage AI agent team workflows across multiple tools. -- **Repository**: agentkit-forge +- **Repository**: retort - **Default Branch**: main +- **Integration Branch** (PR target): dev - **Framework Version**: 3.1.0 - **Phase**: active @@ -213,7 +214,7 @@ The CI `branch-protection` workflow **rejects PRs** with non-conforming titles. When you modify any file in `.agentkit/spec/`, you **MUST** run sync before committing: ```bash -pnpm -C .agentkit agentkit:sync +pnpm -C .agentkit retort:sync ``` Then commit the regenerated output. The CI drift check **will fail** if generated files are out of sync. This is the #1 cause of CI failures across branches. @@ -221,7 +222,7 @@ Then commit the regenerated output. The CI drift check **will fail** if generate **Workflow:** 1. Edit spec files in `.agentkit/spec/` -2. Run `pnpm -C .agentkit agentkit:sync` +2. Run `pnpm -C .agentkit retort:sync` 3. Commit spec changes and generated output together (or in two atomic commits) 4. Verify with `git diff --quiet` — if there's output, you missed something @@ -229,13 +230,23 @@ Then commit the regenerated output. The CI drift check **will fail** if generate Feature branches: `type/short-description` (e.g., `feat/add-user-auth`, `fix/token-refresh`) +### PR Target Branch + +All PRs **must** target `dev` — not `main` or any other branch unless explicitly instructed: + +```bash +gh pr create --base dev --title "type(scope): description" +``` + +The integration branch (`dev`) is the configured PR target for this repo. Creating PRs against `main` directly causes reverse-merge noise and bypasses the integration pipeline. A hookify rule in `.claude/rules/pr-base-branch.md` enforces this at runtime. + ## Safety Rules 1. **Never** commit secrets, API keys, or credentials 2. **Never** force-push to main 3. **Never** run destructive commands without confirmation -4. **Never** modify files in `.agentkit/templates/`, `.agentkit/engines/`, `.agentkit/overlays/`, or `.agentkit/bin/` — these are the upstream source-of-truth for AgentKit Forge and are protected by a PreToolUse hook. Note: `.agentkit/spec/` is the intended edit point for project configuration — modify spec YAML files there and run `agentkit sync` to regenerate output -5. **Never** directly edit files marked `` — modify the spec in `.agentkit/spec/` and run `agentkit sync` instead; if spec files changed, run `pnpm -C .agentkit agentkit:sync` and commit regenerated outputs before creating a PR +4. **Never** modify files in `.agentkit/templates/`, `.agentkit/engines/`, `.agentkit/overlays/`, or `.agentkit/bin/` — these are the upstream source-of-truth for Retort and are protected by a PreToolUse hook. Note: `.agentkit/spec/` is the intended edit point for project configuration — modify spec YAML files there and run `retort sync` to regenerate output +5. **Never** directly edit files marked `` — modify the spec in `.agentkit/spec/` and run `retort sync` instead; if spec files changed, run `pnpm -C .agentkit retort:sync` and commit regenerated outputs before creating a PR 6. **Always** run `/check` before creating a PR 7. **Always** use Conventional Commits format for PR titles: `type(scope): description` — CI rejects non-conforming titles (valid types: feat, fix, docs, style, refactor, test, chore, ci, perf, build, revert) 8. **Always** document breaking changes — PRs with `!:` or `BREAKING` in the title must include a `## Breaking Changes` section, ADR reference, or migration guide in the PR body (CI enforces this) diff --git a/COMMAND_GUIDE.md b/COMMAND_GUIDE.md index 58b8f2e8..895f53f5 100644 --- a/COMMAND_GUIDE.md +++ b/COMMAND_GUIDE.md @@ -1,6 +1,6 @@ - + # Command Guide — When to Use Which This guide helps you choose the right command for your situation. Most workflow commands read/write shared project state (`AGENT_BACKLOG.md`, `.claude/state/orchestrator.json`, `.claude/state/events.log`). Only `/orchestrate` acquires `.claude/state/orchestrator.lock`. @@ -72,7 +72,7 @@ This guide helps you choose the right command for your situation. Most workflow **Use when:** -- You need a quick health signal for AgentKit setup +- You need a quick health signal for Retort setup - Sync/init behavior looks inconsistent and you need actionable checks - You want malformed overlays/spec warnings surfaced before orchestration @@ -214,7 +214,7 @@ This guide helps you choose the right command for your situation. Most workflow | Need a plan before coding | `/plan` | | Full project audit / onboarding | `/project-review` | | Understand repo structure | `/discover` | -| Validate AgentKit setup | `/doctor` | +| Validate Retort setup | `/doctor` | | Verify build/test/lint | `/healthcheck` | | Inspect delegated task queue | `/tasks` | | Delegate work to a team | `/delegate` | diff --git a/GEMINI.md b/GEMINI.md index f6390fbb..4602419c 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -1,11 +1,11 @@ - - - - + + + + -# agentkit-forge — Gemini Instructions +# retort — Gemini Instructions AgentKit Forge framework for multi-tool AI agent team orchestration, sync generation, and quality-gated workflows. diff --git a/QUALITY_GATES.md b/QUALITY_GATES.md index 6e1bc584..18f76ccc 100644 --- a/QUALITY_GATES.md +++ b/QUALITY_GATES.md @@ -1,9 +1,6 @@ - - - - + # Quality Gates — retort @@ -282,5 +279,5 @@ When a quality gate cannot be satisfied and an exemption is needed: --- -_Quality gates are maintained by AgentKit Forge. See UNIFIED_AGENT_TEAMS.md_ +_Quality gates are maintained by Retort. See UNIFIED_AGENT_TEAMS.md_ _for the lifecycle model that these gates support._ diff --git a/RUNBOOK_AI.md b/RUNBOOK_AI.md index d203d4d4..132dfc35 100644 --- a/RUNBOOK_AI.md +++ b/RUNBOOK_AI.md @@ -1,7 +1,3 @@ - - - - # AI Runbook — retort > Operational runbook for AI agent workflows. Covers common scenarios, @@ -22,10 +18,10 @@ | Command | Purpose | | ------------------- | ---------------------------------------- | -| `agentkit sync` | Regenerate all AI tool configs from spec | -| `agentkit validate` | Check config integrity and security | +| `retort sync` | Regenerate all AI tool configs from spec | +| `retort validate` | Check config integrity and security | | `agentkit discover` | Scan repo and detect tech stacks | -| `agentkit init` | Initialize a new repo overlay | +| `retort init` | Initialize a new repo overlay | | `/orchestrate` | Run multi-team coordination workflow | | `/check` | Run quality gates locally | | `/review` | Request code review from relevant teams | @@ -37,29 +33,29 @@ ### First-time Setup 1. Clone the repository -2. Run `agentkit init --repoName ` to create overlay +2. Run `retort init --repoName ` to create overlay 3. Edit `.agentkit/overlays//settings.yaml` as needed -4. Run `agentkit sync` to generate all configs +4. Run `retort sync` to generate all configs 5. Commit the generated files ### Adding a New Team Member (AI Agent) 1. Add agent definition to `.agentkit/spec/agents.yaml` -2. Run `agentkit sync` to regenerate agent files -3. Verify with `agentkit validate` +2. Run `retort sync` to regenerate agent files +3. Verify with `retort validate` ### Updating Permissions 1. Edit `.agentkit/overlays//settings.yaml` 2. Add entries to `permissions.allow` or `permissions.deny` -3. Run `agentkit sync` — deny entries always win over allow -4. Verify with `agentkit validate` +3. Run `retort sync` — deny entries always win over allow +4. Verify with `retort validate` ### Customizing Team Commands 1. Edit `.agentkit/overlays//commands.yaml` 2. Add command overrides (merged at file level with base spec) -3. Run `agentkit sync` +3. Run `retort sync` --- @@ -67,7 +63,7 @@ ### Sync produces unexpected output -- Run `DEBUG=1 agentkit sync` for verbose logging +- Run `DEBUG=1 retort sync` for verbose logging - Check for unresolved placeholder warnings (mustache-style {{key}} tokens) - Verify overlay directory matches `.agentkit-repo` marker @@ -80,7 +76,7 @@ ### Generated files show as modified after clean sync - This indicates drift — someone edited a generated file directly -- Run `agentkit sync` to overwrite with canonical version +- Run `retort sync` to overwrite with canonical version - Commit the regenerated files ### Hook scripts fail @@ -99,12 +95,12 @@ Generated files include a backup-aware atomic write. If sync fails mid-write: 1. Check for leftover `.tmp/` directory in agentkit root 2. If present, delete it: `rm -rf .agentkit/.tmp` -3. Re-run `agentkit sync` +3. Re-run `retort sync` ### Reset to clean state -1. Delete all generated files (those with `GENERATED by AgentKit Forge` header) -2. Run `agentkit sync` to regenerate everything +1. Delete all generated files (those with `GENERATED by Retort` header) +2. Run `retort sync` to regenerate everything 3. Use `git diff` to verify the output ### State file corruption @@ -117,4 +113,4 @@ If `.claude/state/orchestrator.json` becomes corrupted: --- -_This runbook is maintained by AgentKit Forge. Run `pnpm -C .agentkit agentkit:sync` to regenerate._ +_This runbook is maintained by Retort. Run `pnpm -C .agentkit retort:sync` to regenerate._ diff --git a/UNIFIED_AGENT_TEAMS.md b/UNIFIED_AGENT_TEAMS.md index 7d4fb6b8..f5323be8 100644 --- a/UNIFIED_AGENT_TEAMS.md +++ b/UNIFIED_AGENT_TEAMS.md @@ -1,9 +1,6 @@ - - - - + # Unified Agent Teams Specification v1.0 @@ -214,7 +211,7 @@ criteria, activities, and exit criteria (quality gates). - **Objective**: Verify the solution meets requirements. - **Activities**: - Create pull request — **title MUST use Conventional Commits**: `type(scope): description` - - Run `pnpm -C .agentkit agentkit:sync` if any spec files changed, and commit regenerated outputs + - Run `pnpm -C .agentkit retort:sync` if any spec files changed, and commit regenerated outputs - All CI checks must pass (including PR title validation and drift check) - Code review by relevant team members - Manual testing for UI or user-facing changes @@ -334,5 +331,5 @@ For changes that affect all teams (e.g., T9 shared library update): --- -_This specification is maintained by AgentKit Forge. Do not edit directly._ -_Run `pnpm -C .agentkit agentkit:sync` to regenerate from the canonical spec._ +_This specification is maintained by Retort. Do not edit directly._ +_Run `pnpm -C .agentkit retort:sync` to regenerate from the canonical spec._ diff --git a/WARP.md b/WARP.md index 7398b0da..c0c3fffe 100644 --- a/WARP.md +++ b/WARP.md @@ -1,11 +1,11 @@ - - - - + + + + -# agentkit-forge — Warp Instructions +# retort — Warp Instructions AgentKit Forge framework for multi-tool AI agent team orchestration, sync generation, and quality-gated workflows. diff --git a/docs/README.md b/docs/README.md index b2be74b6..7e7f15d6 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,9 +1,6 @@ - - - - + # retort — Documentation @@ -40,9 +37,9 @@ documentation category maintained by this repository. ## Conventions - Placeholder tokens `retort` and `3.1.0` are replaced at sync time. -- Do **not** edit generated files directly — run `pnpm -C .agentkit agentkit:sync` - to regenerate them from the AgentKit Forge spec and overlays. +- Do **not** edit generated files directly — run `pnpm -C .agentkit retort:sync` + to regenerate them from the Retort spec and overlays. --- -Generated by AgentKit Forge v3.1.0 +Generated by Retort v3.1.0 diff --git a/docs/api/README.md b/docs/api/README.md index a022da06..f02f96c3 100644 --- a/docs/api/README.md +++ b/docs/api/README.md @@ -1,6 +1,6 @@ - + # API Docs Index diff --git a/docs/architecture/README.md b/docs/architecture/README.md index a2b4a5ed..13fbf9f9 100644 --- a/docs/architecture/README.md +++ b/docs/architecture/README.md @@ -1,6 +1,6 @@ - + # Architecture Docs Index diff --git a/docs/architecture/decisions/README.md b/docs/architecture/decisions/README.md index 22a13552..cb5bf1ef 100644 --- a/docs/architecture/decisions/README.md +++ b/docs/architecture/decisions/README.md @@ -1,12 +1,12 @@ - + # ADR Index ## Decision Records -- [01-adopt-retort.md](./01-adopt-retort.md) +- [01-adopt-agentkit-forge.md](./01-adopt-agentkit-forge.md) - [02-fallback-policy-tokens-problem.md](./02-fallback-policy-tokens-problem.md) - [03-tooling-strategy.md](./03-tooling-strategy.md) - [04-static-security-analysis-depth-tooling.md](./04-static-security-analysis-depth-tooling.md) diff --git a/docs/architecture/diagrams/README.md b/docs/architecture/diagrams/README.md index 11868964..40969b5d 100644 --- a/docs/architecture/diagrams/README.md +++ b/docs/architecture/diagrams/README.md @@ -1,6 +1,6 @@ - + # Architecture Diagrams Index diff --git a/docs/architecture/specs/README.md b/docs/architecture/specs/README.md index 2ea560d0..4c965e2b 100644 --- a/docs/architecture/specs/README.md +++ b/docs/architecture/specs/README.md @@ -1,6 +1,6 @@ - + # Specs Docs Index diff --git a/docs/engineering/README.md b/docs/engineering/README.md index 2fb206da..371e46ee 100644 --- a/docs/engineering/README.md +++ b/docs/engineering/README.md @@ -1,6 +1,6 @@ - + # Engineering Docs Index diff --git a/docs/history/README.md b/docs/history/README.md index 0cce2880..e02da7b9 100644 --- a/docs/history/README.md +++ b/docs/history/README.md @@ -1,6 +1,6 @@ - + # History diff --git a/docs/history/bug-fixes/README.md b/docs/history/bug-fixes/README.md index 366e8d49..30c456d9 100644 --- a/docs/history/bug-fixes/README.md +++ b/docs/history/bug-fixes/README.md @@ -1,7 +1,18 @@ + +<<<<<<< YOUR_EDITS + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Bug Fixes Historical records of complex or critical bug resolutions. diff --git a/docs/history/features/README.md b/docs/history/features/README.md index 3d63abeb..c4b96207 100644 --- a/docs/history/features/README.md +++ b/docs/history/features/README.md @@ -1,7 +1,18 @@ + +<<<<<<< YOUR_EDITS + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Features Historical records of new feature launches. diff --git a/docs/history/implementations/README.md b/docs/history/implementations/README.md index c4e567cb..ab8d6b4b 100644 --- a/docs/history/implementations/README.md +++ b/docs/history/implementations/README.md @@ -1,7 +1,18 @@ + +<<<<<<< YOUR_EDITS + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Implementations Historical records of major implementations, architecture changes, and significant refactoring. diff --git a/docs/history/issues/README.md b/docs/history/issues/README.md index b7cd22f2..6f123fe0 100644 --- a/docs/history/issues/README.md +++ b/docs/history/issues/README.md @@ -1,7 +1,18 @@ + +<<<<<<< YOUR_EDITS + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Issues Historical records of issues encountered during development sessions. diff --git a/docs/history/lessons-learned/README.md b/docs/history/lessons-learned/README.md index d6714a1c..fc5c5207 100644 --- a/docs/history/lessons-learned/README.md +++ b/docs/history/lessons-learned/README.md @@ -1,7 +1,18 @@ + +<<<<<<< YOUR_EDITS + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Lessons Learned Historical records of lessons learned during development sessions. diff --git a/docs/history/migrations/README.md b/docs/history/migrations/README.md index 23c2d78c..3c573fcb 100644 --- a/docs/history/migrations/README.md +++ b/docs/history/migrations/README.md @@ -1,7 +1,18 @@ + +<<<<<<< YOUR_EDITS + +||||||| LAST_SYNC + +# + + + +> > > > > > > NEW_TEMPLATE + # Migrations Historical records of major migrations and upgrades. diff --git a/docs/integrations/README.md b/docs/integrations/README.md index 9ec06fca..15a61967 100644 --- a/docs/integrations/README.md +++ b/docs/integrations/README.md @@ -1,6 +1,6 @@ - + # Integrations Docs Index diff --git a/docs/operations/README.md b/docs/operations/README.md index f1dab951..1bb25743 100644 --- a/docs/operations/README.md +++ b/docs/operations/README.md @@ -1,6 +1,6 @@ - + # Operations Docs Index diff --git a/docs/product/README.md b/docs/product/README.md index 2054f1b9..cd5a5e78 100644 --- a/docs/product/README.md +++ b/docs/product/README.md @@ -1,6 +1,6 @@ - + # Product Docs Index diff --git a/docs/reference/README.md b/docs/reference/README.md index 45620ea4..2bab7d66 100644 --- a/docs/reference/README.md +++ b/docs/reference/README.md @@ -1,6 +1,6 @@ - + # Reference Docs Index diff --git a/scripts/analyze-agents.ps1 b/scripts/analyze-agents.ps1 index 5b34fe8a..8e2e71f2 100644 --- a/scripts/analyze-agents.ps1 +++ b/scripts/analyze-agents.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> # scripts/analyze-agents.ps1 # Generates agent/team relationship matrices from spec files. diff --git a/scripts/analyze-agents.sh b/scripts/analyze-agents.sh index 6ba0e5e6..80e897eb 100755 --- a/scripts/analyze-agents.sh +++ b/scripts/analyze-agents.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/analyze-agents.sh # Generates agent/team relationship matrices from spec files. # diff --git a/scripts/check-documentation-requirement.sh b/scripts/check-documentation-requirement.sh index 98d752c2..8f486499 100755 --- a/scripts/check-documentation-requirement.sh +++ b/scripts/check-documentation-requirement.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/check-documentation-requirement.sh # Analyzes staged or changed files to determine whether PR documentation is required. # diff --git a/scripts/consolidate-branches.ps1 b/scripts/consolidate-branches.ps1 index 3cdda437..f84a8153 100644 --- a/scripts/consolidate-branches.ps1 +++ b/scripts/consolidate-branches.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> # ============================================================================= # consolidate-branches.ps1 — Merge all unmerged feature branches into one @@ -9,7 +9,7 @@ # # Discovers all local and remote branches not yet merged into , # filters out protected branches, and merges them one by one into the current -# branch. Auto-resolves generated files per the AgentKit merge resolution matrix. +# branch. Auto-resolves generated files per the Retort merge resolution matrix. # ============================================================================= param( [string]$Base = "main", @@ -232,7 +232,7 @@ try { Write-Host "" if ($merged.Count -gt 0) { Write-Info "Next steps:" - Write-Host " 1. Run: pnpm -C .agentkit agentkit:sync" + Write-Host " 1. Run: pnpm -C .agentkit retort:sync" Write-Host " 2. Run: pnpm test" Write-Host " 3. Review with: git log --oneline -20" } diff --git a/scripts/consolidate-branches.sh b/scripts/consolidate-branches.sh index 2444a67b..ea41efc1 100755 --- a/scripts/consolidate-branches.sh +++ b/scripts/consolidate-branches.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # ============================================================================= # consolidate-branches.sh — Merge all unmerged feature branches into one # ============================================================================= diff --git a/scripts/create-doc.ps1 b/scripts/create-doc.ps1 index 6e6c06ee..d3828d3e 100644 --- a/scripts/create-doc.ps1 +++ b/scripts/create-doc.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> # scripts/create-doc.ps1 # Creates a new history document from the appropriate template. diff --git a/scripts/create-doc.sh b/scripts/create-doc.sh index e3765290..2b6208ee 100755 --- a/scripts/create-doc.sh +++ b/scripts/create-doc.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/create-doc.sh # Creates a new history document from the appropriate template. # diff --git a/scripts/resolve-merge.ps1 b/scripts/resolve-merge.ps1 index 2d147f32..953156fa 100644 --- a/scripts/resolve-merge.ps1 +++ b/scripts/resolve-merge.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> # ============================================================================= # resolve-merge.ps1 — Apply standard merge conflict resolutions (Windows) @@ -8,7 +8,7 @@ # Usage: .\scripts\resolve-merge.ps1 [-Target main] # # Merges origin/ into the current branch and auto-resolves -# generated/framework-managed files per the AgentKit merge resolution matrix. +# generated/framework-managed files per the Retort merge resolution matrix. # Remaining conflicts (engine source, spec files) are listed for manual review. # ============================================================================= param( diff --git a/scripts/resolve-merge.sh b/scripts/resolve-merge.sh index 0435d607..2be954b4 100755 --- a/scripts/resolve-merge.sh +++ b/scripts/resolve-merge.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # ============================================================================= # resolve-merge.sh — Apply standard merge conflict resolutions # ============================================================================= diff --git a/scripts/setup-agentkit-branch-governance.ps1 b/scripts/setup-agentkit-branch-governance.ps1 index cd2e727b..26dbde15 100644 --- a/scripts/setup-agentkit-branch-governance.ps1 +++ b/scripts/setup-agentkit-branch-governance.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> [CmdletBinding()] param( @@ -32,7 +32,7 @@ if (-not $Repo) { exit 1 } -Write-Host "=== AgentKit Branch Governance Setup ===" +Write-Host "=== Retort Branch Governance Setup ===" Write-Host "Repository: $Repo" Write-Host "DryRun: $DryRun" Write-Host "" diff --git a/scripts/setup-agentkit-branch-governance.sh b/scripts/setup-agentkit-branch-governance.sh index 350ef362..6aab2efc 100755 --- a/scripts/setup-agentkit-branch-governance.sh +++ b/scripts/setup-agentkit-branch-governance.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync set -euo pipefail REPO="" diff --git a/scripts/sync-issues.sh b/scripts/sync-issues.sh index 25effcb2..8dd7cfaa 100755 --- a/scripts/sync-issues.sh +++ b/scripts/sync-issues.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/sync-issues.sh # Syncs local issue docs (docs/history/issues/) to GitHub Issues. # diff --git a/scripts/sync-split-pr.ps1 b/scripts/sync-split-pr.ps1 index 871ca5f0..46c30399 100644 --- a/scripts/sync-split-pr.ps1 +++ b/scripts/sync-split-pr.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> [CmdletBinding()] param( diff --git a/scripts/sync-split-pr.sh b/scripts/sync-split-pr.sh index 69d5a06a..b8f05e8d 100755 --- a/scripts/sync-split-pr.sh +++ b/scripts/sync-split-pr.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync set -euo pipefail BASE_BRANCH="" diff --git a/scripts/update-changelog.ps1 b/scripts/update-changelog.ps1 index f64bdb0d..96ce8a4b 100644 --- a/scripts/update-changelog.ps1 +++ b/scripts/update-changelog.ps1 @@ -1,6 +1,6 @@ # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync <# agentkit: scaffold: managed #> # scripts/update-changelog.ps1 # Inserts an entry into the [Unreleased] section of CHANGELOG.md. diff --git a/scripts/update-changelog.sh b/scripts/update-changelog.sh index 16244613..6e01743d 100755 --- a/scripts/update-changelog.sh +++ b/scripts/update-changelog.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/update-changelog.sh # Inserts an entry into the [Unreleased] section of CHANGELOG.md. # diff --git a/scripts/validate-documentation.sh b/scripts/validate-documentation.sh index 0d8797ab..a7f65722 100755 --- a/scripts/validate-documentation.sh +++ b/scripts/validate-documentation.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/validate-documentation.sh # Validates that history documents meet structural requirements. # diff --git a/scripts/validate-numbering.sh b/scripts/validate-numbering.sh index 7e31bf84..0864824b 100755 --- a/scripts/validate-numbering.sh +++ b/scripts/validate-numbering.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # GENERATED by Retort v3.1.0 — DO NOT EDIT # Source: .agentkit/spec + .agentkit/overlays/retort -# Regenerate: pnpm -C .agentkit agentkit:sync +# Regenerate: pnpm -C .agentkit retort:sync # scripts/validate-numbering.sh # Validates the sequential numbering of history documents against .index.json. #