From a04392886407f9e3faf60d7af64a74f505292f4e Mon Sep 17 00:00:00 2001 From: Oleg Shulyakov Date: Sun, 24 May 2026 09:56:43 +0300 Subject: [PATCH] refactor: rename skills to verb-first naming convention - Rename codegen-* skills to build-* (backend, database, frontend) - Rename codegen-test to write-tests - Rename creator-rule to create-rule - Rename creator-skill to create-skill - Rename operator-git to manage-git - Rename writer-* skills to write-* (prd, spec, tech-docs, user-story) - Update all internal references and documentation to match new names - Update naming convention docs from type-first to verb-first - Remove deprecated trigger-evals.json files --- .agents/skills/README.md | 30 ++-- .../SKILL.md | 4 +- .../evals/evals.json | 2 +- .../references/ada.md | 0 .../references/c.md | 0 .../references/cpp.md | 0 .../references/csharp-aspnet-core.md | 0 .../references/csharp.md | 0 .../references/delphi.md | 0 .../references/elixir-phoenix.md | 0 .../references/elixir.md | 0 .../references/fortran.md | 0 .../references/go-chi.md | 0 .../references/go-echo.md | 0 .../references/go-fiber.md | 0 .../references/go-gin.md | 0 .../references/go.md | 0 .../references/java-micronaut.md | 0 .../references/java-quarkus.md | 0 .../references/java-spring-boot.md | 0 .../references/java.md | 0 .../references/kotlin-ktor.md | 0 .../references/kotlin.md | 0 .../references/matlab.md | 0 .../references/nodejs-express.md | 0 .../references/nodejs-fastify.md | 0 .../references/nodejs-hono.md | 0 .../references/nodejs-nestjs.md | 0 .../references/nodejs-nitro.md | 0 .../references/nodejs.md | 0 .../references/perl.md | 0 .../references/php-laravel.md | 0 .../references/php-symfony.md | 0 .../references/php.md | 0 .../references/python-django.md | 0 .../references/python-fastapi.md | 0 .../references/python-flask.md | 0 .../references/python.md | 0 .../references/r.md | 0 .../references/ruby-rails.md | 0 .../references/ruby-sinatra.md | 0 .../references/ruby.md | 0 .../references/rust-actix-web.md | 0 .../references/rust-axum.md | 0 .../references/rust-rocket.md | 0 .../references/rust.md | 0 .../references/swift.md | 0 .../references/visual-basic.md | 0 .../SKILL.md | 10 +- .../evals/evals.json | 2 +- .../references/analytics.md | 0 .../references/bigquery.md | 0 .../references/clickhouse.md | 0 .../references/cockroachdb.md | 0 .../references/common.md | 2 +- .../references/migration.md | 0 .../references/mssql.md | 0 .../references/mysql.md | 0 .../references/oracle.md | 0 .../references/postgres.md | 0 .../references/schema-design.md | 0 .../references/snowflake.md | 0 .../references/sqlite.md | 0 .../SKILL.md | 6 +- .../evals/evals.json | 2 +- .../references/accessibility.md | 0 .../references/css-bootstrap.md | 0 .../references/css-component-libraries.md | 0 .../references/css-tailwind.md | 0 .../references/css.md | 0 .../references/forms.md | 0 .../references/html.md | 0 .../references/internationalization.md | 0 .../references/javascript-angular.md | 0 .../references/javascript-astro.md | 0 .../references/javascript-react-nextjs.md | 0 .../references/javascript-react-remix.md | 0 .../references/javascript-react.md | 0 .../references/javascript-solidjs.md | 0 .../references/javascript-svelte-sveltekit.md | 0 .../references/javascript-svelte.md | 0 .../references/javascript-vue-nuxt.md | 0 .../references/javascript-vue.md | 0 .../references/javascript.md | 0 .../references/performance.md | 0 .../references/pwa.md | 0 .../references/state.md | 0 .../references/typescript.md | 0 .../references/visualization.md | 0 .../{creator-rule => create-rule}/SKILL.md | 4 +- .../evals/evals.json | 2 +- .../scripts/grade_rule_output.py | 6 +- .../scripts/run_trigger_eval.py | 8 +- .../scripts/validate_evals.py | 8 +- .../scripts/validate_rule.py | 4 +- .../{creator-skill => create-skill}/SKILL.md | 4 +- .../agents/analyzer.md | 0 .../agents/benchmark-analyzer.md | 0 .../agents/comparator.md | 0 .../agents/grader.md | 2 +- .../assets/eval_review.html | 0 .../eval-viewer/generate_review.py | 0 .../eval-viewer/viewer.html | 0 .../evals/evals.json | 86 +++++----- .../references/agent-compatibility.md | 0 .../references/authoring.md | 4 +- .../references/description-optimization.md | 2 +- .../references/evaluation.md | 0 .../references/review.md | 2 +- .../references/schemas.md | 0 .../scripts/__init__.py | 0 .../scripts/agent_runner.py | 0 .../scripts/aggregate_benchmark.py | 0 .../scripts/generate_report.py | 0 .../scripts/improve_description.py | 0 .../scripts/package_skill.py | 0 .../scripts/quick_validate.py | 0 .../scripts/run_eval.py | 0 .../scripts/run_loop.py | 0 .../scripts/utils.py | 0 .../creator-rule/evals/trigger-evals.json | 102 ------------ .../{operator-git => manage-git}/SKILL.md | 4 +- .../evals/evals.json | 2 +- .../references/branch-naming.md | 0 .../references/commit-message.md | 0 .../evals/scripts/check_contract.py | 91 ----------- .../operator-git/evals/trigger-evals.json | 66 -------- .agents/skills/review-code/evals/evals.json | 2 +- .../skills/{writer-prd => write-prd}/SKILL.md | 4 +- .../evals/evals.json | 2 +- .../references/examples.md | 0 .../references/output-format.md | 0 .../{writer-spec => write-spec}/SKILL.md | 6 +- .../evals/evals.json | 2 +- .../references/data-contract.md | 0 .../references/design-ui.md | 0 .../references/functional.md | 0 .../references/non-functional.md | 0 .../references/technical.md | 0 .../SKILL.md | 6 +- .../evals/evals.json | 2 +- .../references/api-docs.md | 2 +- .../references/changelog.md | 2 +- .../references/readme.md | 2 +- .../references/release-notes.md | 2 +- .../references/runbook-oncall.md | 2 +- .../references/runbook-routine.md | 2 +- .../{codegen-test => write-tests}/SKILL.md | 4 +- .../evals/evals.json | 2 +- .../references/ai-output.md | 0 .../references/ai-perf.md | 2 +- .../references/ai-tool-use.md | 0 .../references/api.md | 0 .../references/e2e.md | 0 .../references/perf.md | 0 .../scripts/__init__.py | 0 .../scripts/agent_runner.py | 0 .../scripts/aggregate_benchmark.py | 0 .../scripts/generate_report.py | 0 .../scripts/improve_description.py | 0 .../scripts/run_eval.py | 0 .../scripts/run_loop.py | 0 .../scripts/scaffold_ai_eval.py | 2 +- .../scripts/summarize_ai_perf.py | 0 .../scripts/utils.py | 0 .../scripts/validate_evals.py | 6 +- .../SKILL.md | 4 +- .../evals/evals.json | 2 +- .../references/ai-output-format.md | 0 .../references/examples.md | 0 .../references/output-format.md | 0 docs/2026-05-02-agent-playbook/SPEC.md | 4 +- docs/2026-05-02-team-roles-as-skills/PRD.md | 22 +-- docs/2026-05-02-team-roles-as-skills/SPEC.md | 152 +++++++++--------- docs/2026-05-02-team-roles-as-skills/TASKS.md | 124 +++++++------- pages/PLAYBOOK.md | 8 +- pages/index.md | 6 +- 177 files changed, 285 insertions(+), 544 deletions(-) rename .agents/skills/{codegen-backend => build-backend}/SKILL.md (99%) rename .agents/skills/{codegen-backend => build-backend}/evals/evals.json (99%) rename .agents/skills/{codegen-backend => build-backend}/references/ada.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/c.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/cpp.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/csharp-aspnet-core.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/csharp.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/delphi.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/elixir-phoenix.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/elixir.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/fortran.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/go-chi.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/go-echo.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/go-fiber.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/go-gin.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/go.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/java-micronaut.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/java-quarkus.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/java-spring-boot.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/java.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/kotlin-ktor.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/kotlin.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/matlab.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/nodejs-express.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/nodejs-fastify.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/nodejs-hono.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/nodejs-nestjs.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/nodejs-nitro.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/nodejs.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/perl.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/php-laravel.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/php-symfony.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/php.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/python-django.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/python-fastapi.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/python-flask.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/python.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/r.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/ruby-rails.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/ruby-sinatra.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/ruby.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/rust-actix-web.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/rust-axum.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/rust-rocket.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/rust.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/swift.md (100%) rename .agents/skills/{codegen-backend => build-backend}/references/visual-basic.md (100%) rename .agents/skills/{codegen-database => build-database}/SKILL.md (90%) rename .agents/skills/{codegen-database => build-database}/evals/evals.json (99%) rename .agents/skills/{codegen-database => build-database}/references/analytics.md (100%) rename .agents/skills/{codegen-database => build-database}/references/bigquery.md (100%) rename .agents/skills/{codegen-database => build-database}/references/clickhouse.md (100%) rename .agents/skills/{codegen-database => build-database}/references/cockroachdb.md (100%) rename .agents/skills/{codegen-database => build-database}/references/common.md (97%) rename .agents/skills/{codegen-database => build-database}/references/migration.md (100%) rename .agents/skills/{codegen-database => build-database}/references/mssql.md (100%) rename .agents/skills/{codegen-database => build-database}/references/mysql.md (100%) rename .agents/skills/{codegen-database => build-database}/references/oracle.md (100%) rename .agents/skills/{codegen-database => build-database}/references/postgres.md (100%) rename .agents/skills/{codegen-database => build-database}/references/schema-design.md (100%) rename .agents/skills/{codegen-database => build-database}/references/snowflake.md (100%) rename .agents/skills/{codegen-database => build-database}/references/sqlite.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/SKILL.md (96%) rename .agents/skills/{codegen-frontend => build-frontend}/evals/evals.json (99%) rename .agents/skills/{codegen-frontend => build-frontend}/references/accessibility.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/css-bootstrap.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/css-component-libraries.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/css-tailwind.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/css.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/forms.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/html.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/internationalization.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-angular.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-astro.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-react-nextjs.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-react-remix.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-react.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-solidjs.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-svelte-sveltekit.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-svelte.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-vue-nuxt.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript-vue.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/javascript.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/performance.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/pwa.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/state.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/typescript.md (100%) rename .agents/skills/{codegen-frontend => build-frontend}/references/visualization.md (100%) rename .agents/skills/{creator-rule => create-rule}/SKILL.md (99%) rename .agents/skills/{creator-rule => create-rule}/evals/evals.json (99%) rename .agents/skills/{creator-rule => create-rule}/scripts/grade_rule_output.py (97%) rename .agents/skills/{creator-rule => create-rule}/scripts/run_trigger_eval.py (96%) rename .agents/skills/{creator-rule => create-rule}/scripts/validate_evals.py (94%) rename .agents/skills/{creator-rule => create-rule}/scripts/validate_rule.py (97%) rename .agents/skills/{creator-skill => create-skill}/SKILL.md (99%) rename .agents/skills/{creator-skill => create-skill}/agents/analyzer.md (100%) rename .agents/skills/{creator-skill => create-skill}/agents/benchmark-analyzer.md (100%) rename .agents/skills/{creator-skill => create-skill}/agents/comparator.md (100%) rename .agents/skills/{creator-skill => create-skill}/agents/grader.md (99%) rename .agents/skills/{creator-skill => create-skill}/assets/eval_review.html (100%) rename .agents/skills/{creator-skill => create-skill}/eval-viewer/generate_review.py (100%) rename .agents/skills/{creator-skill => create-skill}/eval-viewer/viewer.html (100%) rename .agents/skills/{creator-skill => create-skill}/evals/evals.json (87%) rename .agents/skills/{creator-skill => create-skill}/references/agent-compatibility.md (100%) rename .agents/skills/{creator-skill => create-skill}/references/authoring.md (94%) rename .agents/skills/{creator-skill => create-skill}/references/description-optimization.md (96%) rename .agents/skills/{creator-skill => create-skill}/references/evaluation.md (100%) rename .agents/skills/{creator-skill => create-skill}/references/review.md (95%) rename .agents/skills/{creator-skill => create-skill}/references/schemas.md (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/__init__.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/agent_runner.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/aggregate_benchmark.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/generate_report.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/improve_description.py (100%) rename .agents/skills/{creator-skill => create-skill}/scripts/package_skill.py (100%) rename .agents/skills/{creator-skill => create-skill}/scripts/quick_validate.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/run_eval.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/run_loop.py (100%) rename .agents/skills/{codegen-test => create-skill}/scripts/utils.py (100%) delete mode 100644 .agents/skills/creator-rule/evals/trigger-evals.json rename .agents/skills/{operator-git => manage-git}/SKILL.md (98%) rename .agents/skills/{operator-git => manage-git}/evals/evals.json (99%) rename .agents/skills/{operator-git => manage-git}/references/branch-naming.md (100%) rename .agents/skills/{operator-git => manage-git}/references/commit-message.md (100%) delete mode 100644 .agents/skills/operator-git/evals/scripts/check_contract.py delete mode 100644 .agents/skills/operator-git/evals/trigger-evals.json rename .agents/skills/{writer-prd => write-prd}/SKILL.md (99%) rename .agents/skills/{writer-prd => write-prd}/evals/evals.json (99%) rename .agents/skills/{writer-prd => write-prd}/references/examples.md (100%) rename .agents/skills/{writer-prd => write-prd}/references/output-format.md (100%) rename .agents/skills/{writer-spec => write-spec}/SKILL.md (97%) rename .agents/skills/{writer-spec => write-spec}/evals/evals.json (99%) rename .agents/skills/{writer-spec => write-spec}/references/data-contract.md (100%) rename .agents/skills/{writer-spec => write-spec}/references/design-ui.md (100%) rename .agents/skills/{writer-spec => write-spec}/references/functional.md (100%) rename .agents/skills/{writer-spec => write-spec}/references/non-functional.md (100%) rename .agents/skills/{writer-spec => write-spec}/references/technical.md (100%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/SKILL.md (96%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/evals/evals.json (99%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/references/api-docs.md (99%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/references/changelog.md (99%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/references/readme.md (98%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/references/release-notes.md (98%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/references/runbook-oncall.md (99%) rename .agents/skills/{writer-tech-docs => write-tech-docs}/references/runbook-routine.md (98%) rename .agents/skills/{codegen-test => write-tests}/SKILL.md (99%) rename .agents/skills/{codegen-test => write-tests}/evals/evals.json (99%) rename .agents/skills/{codegen-test => write-tests}/references/ai-output.md (100%) rename .agents/skills/{codegen-test => write-tests}/references/ai-perf.md (98%) rename .agents/skills/{codegen-test => write-tests}/references/ai-tool-use.md (100%) rename .agents/skills/{codegen-test => write-tests}/references/api.md (100%) rename .agents/skills/{codegen-test => write-tests}/references/e2e.md (100%) rename .agents/skills/{codegen-test => write-tests}/references/perf.md (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/__init__.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/agent_runner.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/aggregate_benchmark.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/generate_report.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/improve_description.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/run_eval.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/run_loop.py (100%) rename .agents/skills/{codegen-test => write-tests}/scripts/scaffold_ai_eval.py (99%) rename .agents/skills/{codegen-test => write-tests}/scripts/summarize_ai_perf.py (100%) rename .agents/skills/{creator-skill => write-tests}/scripts/utils.py (100%) rename .agents/skills/{codegen-test => write-tests}/scripts/validate_evals.py (96%) rename .agents/skills/{writer-user-story => write-user-story}/SKILL.md (99%) rename .agents/skills/{writer-user-story => write-user-story}/evals/evals.json (99%) rename .agents/skills/{writer-user-story => write-user-story}/references/ai-output-format.md (100%) rename .agents/skills/{writer-user-story => write-user-story}/references/examples.md (100%) rename .agents/skills/{writer-user-story => write-user-story}/references/output-format.md (100%) diff --git a/.agents/skills/README.md b/.agents/skills/README.md index 3532240..8365c35 100644 --- a/.agents/skills/README.md +++ b/.agents/skills/README.md @@ -9,20 +9,20 @@ A complete skill is a directory with a required `SKILL.md` file and optional bun | Skill | Use it for | Notable resources | | --- | --- | --- | | [`audit-skill-security`](audit-skill-security/SKILL.md) | Auditing third-party or local skills before installing, updating, or trusting them. | [`references/audit-protocol.md`](audit-skill-security/references/audit-protocol.md) | -| [`codegen-backend`](codegen-backend/SKILL.md) | Production backend code: APIs, services, middleware, workers, persistence, validation, auth, and backend tests. | [`references/`](codegen-backend/references/), [`evals/`](codegen-backend/evals/) | -| [`codegen-database`](codegen-database/SKILL.md) | Database code: schemas, DDL, OLTP SQL, analytics SQL, migrations, indexes, stored procedures, and dialect-specific scripts. | [`references/`](codegen-database/references/), [`evals/`](codegen-database/evals/) | -| [`codegen-frontend`](codegen-frontend/SKILL.md) | Production frontend code: components, routes, client state, forms, styling, accessibility, performance, PWA behavior, and visualization. | [`references/`](codegen-frontend/references/), [`evals/`](codegen-frontend/evals/) | -| [`codegen-test`](codegen-test/SKILL.md) | Automated tests and evals, including E2E, API, integration, performance, AI output, tool-use, RAG, and prompt regression suites. | [`references/`](codegen-test/references/), [`scripts/`](codegen-test/scripts/), [`evals/`](codegen-test/evals/) | -| [`creator-rule`](creator-rule/SKILL.md) | Writing or improving agent rules, instruction files, `AGENTS.md`, `CLAUDE.md`, Cursor rules, Copilot instructions, and `.agents/rules/*.md`. | [`scripts/`](creator-rule/scripts/), [`evals/`](creator-rule/evals/) | -| [`creator-skill`](creator-skill/SKILL.md) | Creating, editing, reviewing, evaluating, packaging, optimizing, or improving skills. Start here for skill authoring. | [`references/`](creator-skill/references/), [`scripts/`](creator-skill/scripts/), [`eval-viewer/`](creator-skill/eval-viewer/), [`agents/`](creator-skill/agents/), [`assets/`](creator-skill/assets/), [`evals/`](creator-skill/evals/) | +| [`build-backend`](build-backend/SKILL.md) | Production backend code: APIs, services, middleware, workers, persistence, validation, auth, and backend tests. | [`references/`](build-backend/references/), [`evals/`](build-backend/evals/) | +| [`build-database`](build-database/SKILL.md) | Database code: schemas, DDL, OLTP SQL, analytics SQL, migrations, indexes, stored procedures, and dialect-specific scripts. | [`references/`](build-database/references/), [`evals/`](build-database/evals/) | +| [`build-frontend`](build-frontend/SKILL.md) | Production frontend code: components, routes, client state, forms, styling, accessibility, performance, PWA behavior, and visualization. | [`references/`](build-frontend/references/), [`evals/`](build-frontend/evals/) | +| [`write-tests`](write-tests/SKILL.md) | Automated tests and evals, including E2E, API, integration, performance, AI output, tool-use, RAG, and prompt regression suites. | [`references/`](write-tests/references/), [`scripts/`](write-tests/scripts/), [`evals/`](write-tests/evals/) | +| [`create-rule`](create-rule/SKILL.md) | Writing or improving agent rules, instruction files, `AGENTS.md`, `CLAUDE.md`, Cursor rules, Copilot instructions, and `.agents/rules/*.md`. | [`scripts/`](create-rule/scripts/), [`evals/`](create-rule/evals/) | +| [`create-skill`](create-skill/SKILL.md) | Creating, editing, reviewing, evaluating, packaging, optimizing, or improving skills. Start here for skill authoring. | [`references/`](create-skill/references/), [`scripts/`](create-skill/scripts/), [`eval-viewer/`](create-skill/eval-viewer/), [`agents/`](create-skill/agents/), [`assets/`](create-skill/assets/), [`evals/`](create-skill/evals/) | | [`design-api`](design-api/SKILL.md) | Contract-first API design for OpenAPI, AsyncAPI, GraphQL, endpoints, schemas, and request/response shapes. | [`references/`](design-api/references/), [`evals/`](design-api/evals/) | | [`explain`](explain/SKILL.md) | Explaining general knowledge, concepts, code, behavior, design, architecture, APIs, data flow, and tradeoffs in simple terms. | [`evals/`](explain/evals/) | -| [`operator-git`](operator-git/SKILL.md) | Git branch naming, branch actions, commit-message drafting, and committing staged changes. | [`references/`](operator-git/references/), [`evals/`](operator-git/evals/) | +| [`manage-git`](manage-git/SKILL.md) | Git branch naming, branch actions, commit-message drafting, and committing staged changes. | [`references/`](manage-git/references/), [`evals/`](manage-git/evals/) | | [`review-code`](review-code/SKILL.md) | Reviewing code changes, diffs, pull requests, branches, or patches for correctness, regressions, security, performance, and test gaps. | [`references/`](review-code/references/), [`evals/`](review-code/evals/) | -| [`writer-prd`](writer-prd/SKILL.md) | Product requirements, product briefs, feature requirements, product scope, and launch requirements. | [`references/`](writer-prd/references/), [`evals/`](writer-prd/evals/) | -| [`writer-spec`](writer-spec/SKILL.md) | Technical specs, design docs, functional and non-functional requirements, data contracts, UI specs, release specs, and handoff docs. | [`references/`](writer-spec/references/), [`evals/`](writer-spec/evals/) | -| [`writer-tech-docs`](writer-tech-docs/SKILL.md) | READMEs, API docs, endpoint references, routine and on-call runbooks, changelogs, and release notes. | [`references/`](writer-tech-docs/references/), [`evals/`](writer-tech-docs/evals/) | -| [`writer-user-story`](writer-user-story/SKILL.md) | User stories, acceptance criteria, developer tasks, tickets, story points, and sprint planning breakdowns. | [`references/`](writer-user-story/references/), [`evals/`](writer-user-story/evals/) | +| [`write-prd`](write-prd/SKILL.md) | Product requirements, product briefs, feature requirements, product scope, and launch requirements. | [`references/`](write-prd/references/), [`evals/`](write-prd/evals/) | +| [`write-spec`](write-spec/SKILL.md) | Technical specs, design docs, functional and non-functional requirements, data contracts, UI specs, release specs, and handoff docs. | [`references/`](write-spec/references/), [`evals/`](write-spec/evals/) | +| [`write-tech-docs`](write-tech-docs/SKILL.md) | READMEs, API docs, endpoint references, routine and on-call runbooks, changelogs, and release notes. | [`references/`](write-tech-docs/references/), [`evals/`](write-tech-docs/evals/) | +| [`write-user-story`](write-user-story/SKILL.md) | User stories, acceptance criteria, developer tasks, tickets, story points, and sprint planning breakdowns. | [`references/`](write-user-story/references/), [`evals/`](write-user-story/evals/) | ## Resource Folders @@ -36,17 +36,17 @@ A complete skill is a directory with a required `SKILL.md` file and optional bun ## Common Entry Points -Use [`creator-skill`](creator-skill/SKILL.md) to create, revise, package, or evaluate skills. Its schema notes live in [`creator-skill/references/schemas.md`](creator-skill/references/schemas.md), and its package command is: +Use [`create-skill`](create-skill/SKILL.md) to create, revise, package, or evaluate skills. Its schema notes live in [`create-skill/references/schemas.md`](create-skill/references/schemas.md), and its package command is: ```bash -cd .agents/skills/creator-skill -python3 -m scripts.package_skill ../codegen-database /tmp/skills-dist +cd .agents/skills/create-skill +python3 -m scripts.package_skill ../build-database /tmp/skills-dist ``` Use this validation command when changing an existing skill: ```bash -python3 .agents/skills/creator-skill/scripts/quick_validate.py .agents/skills/codegen-database +python3 .agents/skills/create-skill/scripts/quick_validate.py .agents/skills/build-database ``` The key rule is simple: keep `SKILL.md` and any files it references together. If a skill says to read `references/postgres.md`, that file must remain available relative to the skill folder. Tiny rule, large consequences. Filesystems enjoy pettiness. diff --git a/.agents/skills/codegen-backend/SKILL.md b/.agents/skills/build-backend/SKILL.md similarity index 99% rename from .agents/skills/codegen-backend/SKILL.md rename to .agents/skills/build-backend/SKILL.md index 2fd04d3..367d62e 100644 --- a/.agents/skills/codegen-backend/SKILL.md +++ b/.agents/skills/build-backend/SKILL.md @@ -1,5 +1,5 @@ --- -name: codegen-backend +name: build-backend description: Build or modify backend implementation. Use for API routes, services, middleware, workers, persistence, validation, authorization, configuration, observability, and backend behavior tests. license: MIT version: 1.1.0 @@ -12,7 +12,7 @@ metadata: catalog: software-team-roles --- -# codegen-backend +# build-backend Implement backend code for APIs, services, workers, persistence, middleware, validation, authorization, configuration, observability, and behavior tests. Use this as a router: identify the backend language from the request and repository, read exactly one language reference, and read at most one framework reference when the framework signal is explicit or unambiguous. diff --git a/.agents/skills/codegen-backend/evals/evals.json b/.agents/skills/build-backend/evals/evals.json similarity index 99% rename from .agents/skills/codegen-backend/evals/evals.json rename to .agents/skills/build-backend/evals/evals.json index 4420bc0..8b95d37 100644 --- a/.agents/skills/codegen-backend/evals/evals.json +++ b/.agents/skills/build-backend/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "codegen-backend", + "skill_name": "build-backend", "evals": [ { "id": 1, diff --git a/.agents/skills/codegen-backend/references/ada.md b/.agents/skills/build-backend/references/ada.md similarity index 100% rename from .agents/skills/codegen-backend/references/ada.md rename to .agents/skills/build-backend/references/ada.md diff --git a/.agents/skills/codegen-backend/references/c.md b/.agents/skills/build-backend/references/c.md similarity index 100% rename from .agents/skills/codegen-backend/references/c.md rename to .agents/skills/build-backend/references/c.md diff --git a/.agents/skills/codegen-backend/references/cpp.md b/.agents/skills/build-backend/references/cpp.md similarity index 100% rename from .agents/skills/codegen-backend/references/cpp.md rename to .agents/skills/build-backend/references/cpp.md diff --git a/.agents/skills/codegen-backend/references/csharp-aspnet-core.md b/.agents/skills/build-backend/references/csharp-aspnet-core.md similarity index 100% rename from .agents/skills/codegen-backend/references/csharp-aspnet-core.md rename to .agents/skills/build-backend/references/csharp-aspnet-core.md diff --git a/.agents/skills/codegen-backend/references/csharp.md b/.agents/skills/build-backend/references/csharp.md similarity index 100% rename from .agents/skills/codegen-backend/references/csharp.md rename to .agents/skills/build-backend/references/csharp.md diff --git a/.agents/skills/codegen-backend/references/delphi.md b/.agents/skills/build-backend/references/delphi.md similarity index 100% rename from .agents/skills/codegen-backend/references/delphi.md rename to .agents/skills/build-backend/references/delphi.md diff --git a/.agents/skills/codegen-backend/references/elixir-phoenix.md b/.agents/skills/build-backend/references/elixir-phoenix.md similarity index 100% rename from .agents/skills/codegen-backend/references/elixir-phoenix.md rename to .agents/skills/build-backend/references/elixir-phoenix.md diff --git a/.agents/skills/codegen-backend/references/elixir.md b/.agents/skills/build-backend/references/elixir.md similarity index 100% rename from .agents/skills/codegen-backend/references/elixir.md rename to .agents/skills/build-backend/references/elixir.md diff --git a/.agents/skills/codegen-backend/references/fortran.md b/.agents/skills/build-backend/references/fortran.md similarity index 100% rename from .agents/skills/codegen-backend/references/fortran.md rename to .agents/skills/build-backend/references/fortran.md diff --git a/.agents/skills/codegen-backend/references/go-chi.md b/.agents/skills/build-backend/references/go-chi.md similarity index 100% rename from .agents/skills/codegen-backend/references/go-chi.md rename to .agents/skills/build-backend/references/go-chi.md diff --git a/.agents/skills/codegen-backend/references/go-echo.md b/.agents/skills/build-backend/references/go-echo.md similarity index 100% rename from .agents/skills/codegen-backend/references/go-echo.md rename to .agents/skills/build-backend/references/go-echo.md diff --git a/.agents/skills/codegen-backend/references/go-fiber.md b/.agents/skills/build-backend/references/go-fiber.md similarity index 100% rename from .agents/skills/codegen-backend/references/go-fiber.md rename to .agents/skills/build-backend/references/go-fiber.md diff --git a/.agents/skills/codegen-backend/references/go-gin.md b/.agents/skills/build-backend/references/go-gin.md similarity index 100% rename from .agents/skills/codegen-backend/references/go-gin.md rename to .agents/skills/build-backend/references/go-gin.md diff --git a/.agents/skills/codegen-backend/references/go.md b/.agents/skills/build-backend/references/go.md similarity index 100% rename from .agents/skills/codegen-backend/references/go.md rename to .agents/skills/build-backend/references/go.md diff --git a/.agents/skills/codegen-backend/references/java-micronaut.md b/.agents/skills/build-backend/references/java-micronaut.md similarity index 100% rename from .agents/skills/codegen-backend/references/java-micronaut.md rename to .agents/skills/build-backend/references/java-micronaut.md diff --git a/.agents/skills/codegen-backend/references/java-quarkus.md b/.agents/skills/build-backend/references/java-quarkus.md similarity index 100% rename from .agents/skills/codegen-backend/references/java-quarkus.md rename to .agents/skills/build-backend/references/java-quarkus.md diff --git a/.agents/skills/codegen-backend/references/java-spring-boot.md b/.agents/skills/build-backend/references/java-spring-boot.md similarity index 100% rename from .agents/skills/codegen-backend/references/java-spring-boot.md rename to .agents/skills/build-backend/references/java-spring-boot.md diff --git a/.agents/skills/codegen-backend/references/java.md b/.agents/skills/build-backend/references/java.md similarity index 100% rename from .agents/skills/codegen-backend/references/java.md rename to .agents/skills/build-backend/references/java.md diff --git a/.agents/skills/codegen-backend/references/kotlin-ktor.md b/.agents/skills/build-backend/references/kotlin-ktor.md similarity index 100% rename from .agents/skills/codegen-backend/references/kotlin-ktor.md rename to .agents/skills/build-backend/references/kotlin-ktor.md diff --git a/.agents/skills/codegen-backend/references/kotlin.md b/.agents/skills/build-backend/references/kotlin.md similarity index 100% rename from .agents/skills/codegen-backend/references/kotlin.md rename to .agents/skills/build-backend/references/kotlin.md diff --git a/.agents/skills/codegen-backend/references/matlab.md b/.agents/skills/build-backend/references/matlab.md similarity index 100% rename from .agents/skills/codegen-backend/references/matlab.md rename to .agents/skills/build-backend/references/matlab.md diff --git a/.agents/skills/codegen-backend/references/nodejs-express.md b/.agents/skills/build-backend/references/nodejs-express.md similarity index 100% rename from .agents/skills/codegen-backend/references/nodejs-express.md rename to .agents/skills/build-backend/references/nodejs-express.md diff --git a/.agents/skills/codegen-backend/references/nodejs-fastify.md b/.agents/skills/build-backend/references/nodejs-fastify.md similarity index 100% rename from .agents/skills/codegen-backend/references/nodejs-fastify.md rename to .agents/skills/build-backend/references/nodejs-fastify.md diff --git a/.agents/skills/codegen-backend/references/nodejs-hono.md b/.agents/skills/build-backend/references/nodejs-hono.md similarity index 100% rename from .agents/skills/codegen-backend/references/nodejs-hono.md rename to .agents/skills/build-backend/references/nodejs-hono.md diff --git a/.agents/skills/codegen-backend/references/nodejs-nestjs.md b/.agents/skills/build-backend/references/nodejs-nestjs.md similarity index 100% rename from .agents/skills/codegen-backend/references/nodejs-nestjs.md rename to .agents/skills/build-backend/references/nodejs-nestjs.md diff --git a/.agents/skills/codegen-backend/references/nodejs-nitro.md b/.agents/skills/build-backend/references/nodejs-nitro.md similarity index 100% rename from .agents/skills/codegen-backend/references/nodejs-nitro.md rename to .agents/skills/build-backend/references/nodejs-nitro.md diff --git a/.agents/skills/codegen-backend/references/nodejs.md b/.agents/skills/build-backend/references/nodejs.md similarity index 100% rename from .agents/skills/codegen-backend/references/nodejs.md rename to .agents/skills/build-backend/references/nodejs.md diff --git a/.agents/skills/codegen-backend/references/perl.md b/.agents/skills/build-backend/references/perl.md similarity index 100% rename from .agents/skills/codegen-backend/references/perl.md rename to .agents/skills/build-backend/references/perl.md diff --git a/.agents/skills/codegen-backend/references/php-laravel.md b/.agents/skills/build-backend/references/php-laravel.md similarity index 100% rename from .agents/skills/codegen-backend/references/php-laravel.md rename to .agents/skills/build-backend/references/php-laravel.md diff --git a/.agents/skills/codegen-backend/references/php-symfony.md b/.agents/skills/build-backend/references/php-symfony.md similarity index 100% rename from .agents/skills/codegen-backend/references/php-symfony.md rename to .agents/skills/build-backend/references/php-symfony.md diff --git a/.agents/skills/codegen-backend/references/php.md b/.agents/skills/build-backend/references/php.md similarity index 100% rename from .agents/skills/codegen-backend/references/php.md rename to .agents/skills/build-backend/references/php.md diff --git a/.agents/skills/codegen-backend/references/python-django.md b/.agents/skills/build-backend/references/python-django.md similarity index 100% rename from .agents/skills/codegen-backend/references/python-django.md rename to .agents/skills/build-backend/references/python-django.md diff --git a/.agents/skills/codegen-backend/references/python-fastapi.md b/.agents/skills/build-backend/references/python-fastapi.md similarity index 100% rename from .agents/skills/codegen-backend/references/python-fastapi.md rename to .agents/skills/build-backend/references/python-fastapi.md diff --git a/.agents/skills/codegen-backend/references/python-flask.md b/.agents/skills/build-backend/references/python-flask.md similarity index 100% rename from .agents/skills/codegen-backend/references/python-flask.md rename to .agents/skills/build-backend/references/python-flask.md diff --git a/.agents/skills/codegen-backend/references/python.md b/.agents/skills/build-backend/references/python.md similarity index 100% rename from .agents/skills/codegen-backend/references/python.md rename to .agents/skills/build-backend/references/python.md diff --git a/.agents/skills/codegen-backend/references/r.md b/.agents/skills/build-backend/references/r.md similarity index 100% rename from .agents/skills/codegen-backend/references/r.md rename to .agents/skills/build-backend/references/r.md diff --git a/.agents/skills/codegen-backend/references/ruby-rails.md b/.agents/skills/build-backend/references/ruby-rails.md similarity index 100% rename from .agents/skills/codegen-backend/references/ruby-rails.md rename to .agents/skills/build-backend/references/ruby-rails.md diff --git a/.agents/skills/codegen-backend/references/ruby-sinatra.md b/.agents/skills/build-backend/references/ruby-sinatra.md similarity index 100% rename from .agents/skills/codegen-backend/references/ruby-sinatra.md rename to .agents/skills/build-backend/references/ruby-sinatra.md diff --git a/.agents/skills/codegen-backend/references/ruby.md b/.agents/skills/build-backend/references/ruby.md similarity index 100% rename from .agents/skills/codegen-backend/references/ruby.md rename to .agents/skills/build-backend/references/ruby.md diff --git a/.agents/skills/codegen-backend/references/rust-actix-web.md b/.agents/skills/build-backend/references/rust-actix-web.md similarity index 100% rename from .agents/skills/codegen-backend/references/rust-actix-web.md rename to .agents/skills/build-backend/references/rust-actix-web.md diff --git a/.agents/skills/codegen-backend/references/rust-axum.md b/.agents/skills/build-backend/references/rust-axum.md similarity index 100% rename from .agents/skills/codegen-backend/references/rust-axum.md rename to .agents/skills/build-backend/references/rust-axum.md diff --git a/.agents/skills/codegen-backend/references/rust-rocket.md b/.agents/skills/build-backend/references/rust-rocket.md similarity index 100% rename from .agents/skills/codegen-backend/references/rust-rocket.md rename to .agents/skills/build-backend/references/rust-rocket.md diff --git a/.agents/skills/codegen-backend/references/rust.md b/.agents/skills/build-backend/references/rust.md similarity index 100% rename from .agents/skills/codegen-backend/references/rust.md rename to .agents/skills/build-backend/references/rust.md diff --git a/.agents/skills/codegen-backend/references/swift.md b/.agents/skills/build-backend/references/swift.md similarity index 100% rename from .agents/skills/codegen-backend/references/swift.md rename to .agents/skills/build-backend/references/swift.md diff --git a/.agents/skills/codegen-backend/references/visual-basic.md b/.agents/skills/build-backend/references/visual-basic.md similarity index 100% rename from .agents/skills/codegen-backend/references/visual-basic.md rename to .agents/skills/build-backend/references/visual-basic.md diff --git a/.agents/skills/codegen-database/SKILL.md b/.agents/skills/build-database/SKILL.md similarity index 90% rename from .agents/skills/codegen-database/SKILL.md rename to .agents/skills/build-database/SKILL.md index 7218dfb..b17a02a 100644 --- a/.agents/skills/codegen-database/SKILL.md +++ b/.agents/skills/build-database/SKILL.md @@ -1,5 +1,5 @@ --- -name: codegen-database +name: build-database description: > Generate or modify database code: schemas, DDL, SQL queries, migrations, analytics SQL, indexes, stored procedures, and dialect-specific database scripts. @@ -14,9 +14,9 @@ metadata: catalog: software-team-roles --- -# codegen-database +# build-database -Generate production-ready database code for schemas, DDL, OLTP queries, analytics SQL, migrations, indexes, stored procedures, and dialect-specific scripts. Use this as a router: classify the database artifact first, detect the dialect from context or repository evidence, then read only the relevant references. +Generate production-ready database code for schemas, DDL, OLTP queries, analytics SQL, migrations, indexes, stored procedures, and dialect-specific scripts. Use this as a router: classify-content the database artifact first, detect the dialect from context or repository evidence, then read only the relevant references. ## Variant Detection @@ -26,7 +26,7 @@ Generate production-ready database code for schemas, DDL, OLTP queries, analytic - **Migrations:** Requests for up/down migrations, Flyway, Liquibase, Rails/ActiveRecord migrations, Alembic, Prisma migrations, rollback, data backfills, or deployment-safe DDL route to `references/migration.md`. - **OLTP SQL:** Requests for queries, DML, views, indexes, transactions, upserts, stored procedures, or query optimization route to `references/common.md`, then the dialect reference. - **Analytics SQL:** Requests for warehouses, metrics, cohorts, funnels, retention, partitioned fact tables, dbt-like transformations, BigQuery, Snowflake, or ClickHouse route to `references/analytics.md`, then any matching warehouse reference. -- **Adjacent skills:** Use `report-db-health` for database health findings from existing telemetry. Use `strategy-backup` for backup and recovery policy. Use `writer-spec` for data contracts when the output is prose rather than executable database code. +- **Adjacent skills:** Use `report-db-health` for database health findings from existing telemetry. Use `plan-backup` for backup and recovery policy. Use `write-spec` for data contracts when the output is prose rather than executable database code. - **Ambiguity:** If the artifact type or database remains genuinely ambiguous after inspecting context, ask one short question naming the likely choices. ## Dialect Routing @@ -57,7 +57,7 @@ If the user asks for portable SQL, use `references/common.md` and avoid dialect- - **Use parameters:** Never generate SQL that interpolates user input into executable statements. Use the placeholder style for the target dialect or framework. - **Index deliberately:** Tie each recommended index to a query, constraint, or access pattern. Avoid adding write-costly indexes without a reason. - **Handle concurrency:** Use transactions, locks, isolation levels, uniqueness, idempotency keys, or retry notes when the database operation can race. -- **Respect dialect limits:** Do not mix syntax across engines. If the dialect is unknown and syntax materially differs, ask once instead of producing decorative nonsense in SQL clothing. +- **Respect dialect limits:** Do not mix syntax across engines. If the dialect is unknown and syntax materially differs, ask-questions once instead of producing decorative nonsense in SQL clothing. - **Verify locally:** Run the narrowest relevant migration check, SQL parser, formatter, test, or application test available. If no database is available, state what was reviewed statically. ## Implementation Flow diff --git a/.agents/skills/codegen-database/evals/evals.json b/.agents/skills/build-database/evals/evals.json similarity index 99% rename from .agents/skills/codegen-database/evals/evals.json rename to .agents/skills/build-database/evals/evals.json index 85ab6d1..9380bc4 100644 --- a/.agents/skills/codegen-database/evals/evals.json +++ b/.agents/skills/build-database/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "codegen-database", + "skill_name": "build-database", "evals": [ { "id": 1, diff --git a/.agents/skills/codegen-database/references/analytics.md b/.agents/skills/build-database/references/analytics.md similarity index 100% rename from .agents/skills/codegen-database/references/analytics.md rename to .agents/skills/build-database/references/analytics.md diff --git a/.agents/skills/codegen-database/references/bigquery.md b/.agents/skills/build-database/references/bigquery.md similarity index 100% rename from .agents/skills/codegen-database/references/bigquery.md rename to .agents/skills/build-database/references/bigquery.md diff --git a/.agents/skills/codegen-database/references/clickhouse.md b/.agents/skills/build-database/references/clickhouse.md similarity index 100% rename from .agents/skills/codegen-database/references/clickhouse.md rename to .agents/skills/build-database/references/clickhouse.md diff --git a/.agents/skills/codegen-database/references/cockroachdb.md b/.agents/skills/build-database/references/cockroachdb.md similarity index 100% rename from .agents/skills/codegen-database/references/cockroachdb.md rename to .agents/skills/build-database/references/cockroachdb.md diff --git a/.agents/skills/codegen-database/references/common.md b/.agents/skills/build-database/references/common.md similarity index 97% rename from .agents/skills/codegen-database/references/common.md rename to .agents/skills/build-database/references/common.md index 606bbd0..e03134c 100644 --- a/.agents/skills/codegen-database/references/common.md +++ b/.agents/skills/build-database/references/common.md @@ -12,7 +12,7 @@ Identify the dialect from context. Check in this order: 2. File extensions or migration tool conventions (`.sql`, Flyway prefix `V1__`, Liquibase) 3. Code imports (`pg`, `mysql2`, `sqlite3`, `pyodbc`) 4. Infrastructure mentions ("RDS Postgres", "Azure SQL", etc.) -5. If genuinely ambiguous: ask once — "Which database are you using? (PostgreSQL, MySQL, MSSQL, SQLite, Oracle)" +5. If genuinely ambiguous: ask-questions once — "Which database are you using? (PostgreSQL, MySQL, MSSQL, SQLite, Oracle)" Once identified, load the dialect-specific reference for syntax details: diff --git a/.agents/skills/codegen-database/references/migration.md b/.agents/skills/build-database/references/migration.md similarity index 100% rename from .agents/skills/codegen-database/references/migration.md rename to .agents/skills/build-database/references/migration.md diff --git a/.agents/skills/codegen-database/references/mssql.md b/.agents/skills/build-database/references/mssql.md similarity index 100% rename from .agents/skills/codegen-database/references/mssql.md rename to .agents/skills/build-database/references/mssql.md diff --git a/.agents/skills/codegen-database/references/mysql.md b/.agents/skills/build-database/references/mysql.md similarity index 100% rename from .agents/skills/codegen-database/references/mysql.md rename to .agents/skills/build-database/references/mysql.md diff --git a/.agents/skills/codegen-database/references/oracle.md b/.agents/skills/build-database/references/oracle.md similarity index 100% rename from .agents/skills/codegen-database/references/oracle.md rename to .agents/skills/build-database/references/oracle.md diff --git a/.agents/skills/codegen-database/references/postgres.md b/.agents/skills/build-database/references/postgres.md similarity index 100% rename from .agents/skills/codegen-database/references/postgres.md rename to .agents/skills/build-database/references/postgres.md diff --git a/.agents/skills/codegen-database/references/schema-design.md b/.agents/skills/build-database/references/schema-design.md similarity index 100% rename from .agents/skills/codegen-database/references/schema-design.md rename to .agents/skills/build-database/references/schema-design.md diff --git a/.agents/skills/codegen-database/references/snowflake.md b/.agents/skills/build-database/references/snowflake.md similarity index 100% rename from .agents/skills/codegen-database/references/snowflake.md rename to .agents/skills/build-database/references/snowflake.md diff --git a/.agents/skills/codegen-database/references/sqlite.md b/.agents/skills/build-database/references/sqlite.md similarity index 100% rename from .agents/skills/codegen-database/references/sqlite.md rename to .agents/skills/build-database/references/sqlite.md diff --git a/.agents/skills/codegen-frontend/SKILL.md b/.agents/skills/build-frontend/SKILL.md similarity index 96% rename from .agents/skills/codegen-frontend/SKILL.md rename to .agents/skills/build-frontend/SKILL.md index b489c0f..153a716 100644 --- a/.agents/skills/codegen-frontend/SKILL.md +++ b/.agents/skills/build-frontend/SKILL.md @@ -1,5 +1,5 @@ --- -name: codegen-frontend +name: build-frontend description: Generate production-ready frontend code. Use for components, pages, routes, client state, forms, styling, accessibility, performance, PWA behavior, and data visualization. license: MIT version: 1.1.0 @@ -12,7 +12,7 @@ metadata: catalog: software-team-roles --- -# codegen-frontend +# build-frontend Implement production frontend work by routing to the smallest relevant reference set, matching the repository's existing architecture, and verifying the user-facing behavior. @@ -23,7 +23,7 @@ Implement production frontend work by routing to the smallest relevant reference - **User signals:** Look for framework names, route or page names, component libraries, state libraries, CSS systems, test tools, file paths, file extensions, and requested user-facing behavior. - **Repository signals:** Inspect `package.json`, lockfiles, framework configs, `tsconfig.json`, source folders, imports, routing structure, design tokens, Storybook, test setup, and CI jobs before choosing an implementation path. - **Frontend scope:** Use this skill for components, pages, layouts, routes, loaders/actions, forms, stores, queries, charts, responsive styling, accessibility fixes, PWA behavior, and frontend performance work. -- **Route away:** Use `codegen-test` for test-only work, `design-api` for API contract design, `codegen-backend` for backend implementation, and `writer-spec` or a design skill for UI/UX specification when no code is requested. +- **Route away:** Use `write-tests` for test-only work, `design-api` for API contract design, `build-backend` for backend implementation, and `write-spec` or a design skill for UI/UX specification when no code is requested. - **Clarify rarely:** If the framework, styling system, or target surface remains genuinely ambiguous after inspection, ask one short question naming the likely options. ## Reference Routing diff --git a/.agents/skills/codegen-frontend/evals/evals.json b/.agents/skills/build-frontend/evals/evals.json similarity index 99% rename from .agents/skills/codegen-frontend/evals/evals.json rename to .agents/skills/build-frontend/evals/evals.json index 0b12545..4e22e3a 100644 --- a/.agents/skills/codegen-frontend/evals/evals.json +++ b/.agents/skills/build-frontend/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "codegen-frontend", + "skill_name": "build-frontend", "evals": [ { "id": 1, diff --git a/.agents/skills/codegen-frontend/references/accessibility.md b/.agents/skills/build-frontend/references/accessibility.md similarity index 100% rename from .agents/skills/codegen-frontend/references/accessibility.md rename to .agents/skills/build-frontend/references/accessibility.md diff --git a/.agents/skills/codegen-frontend/references/css-bootstrap.md b/.agents/skills/build-frontend/references/css-bootstrap.md similarity index 100% rename from .agents/skills/codegen-frontend/references/css-bootstrap.md rename to .agents/skills/build-frontend/references/css-bootstrap.md diff --git a/.agents/skills/codegen-frontend/references/css-component-libraries.md b/.agents/skills/build-frontend/references/css-component-libraries.md similarity index 100% rename from .agents/skills/codegen-frontend/references/css-component-libraries.md rename to .agents/skills/build-frontend/references/css-component-libraries.md diff --git a/.agents/skills/codegen-frontend/references/css-tailwind.md b/.agents/skills/build-frontend/references/css-tailwind.md similarity index 100% rename from .agents/skills/codegen-frontend/references/css-tailwind.md rename to .agents/skills/build-frontend/references/css-tailwind.md diff --git a/.agents/skills/codegen-frontend/references/css.md b/.agents/skills/build-frontend/references/css.md similarity index 100% rename from .agents/skills/codegen-frontend/references/css.md rename to .agents/skills/build-frontend/references/css.md diff --git a/.agents/skills/codegen-frontend/references/forms.md b/.agents/skills/build-frontend/references/forms.md similarity index 100% rename from .agents/skills/codegen-frontend/references/forms.md rename to .agents/skills/build-frontend/references/forms.md diff --git a/.agents/skills/codegen-frontend/references/html.md b/.agents/skills/build-frontend/references/html.md similarity index 100% rename from .agents/skills/codegen-frontend/references/html.md rename to .agents/skills/build-frontend/references/html.md diff --git a/.agents/skills/codegen-frontend/references/internationalization.md b/.agents/skills/build-frontend/references/internationalization.md similarity index 100% rename from .agents/skills/codegen-frontend/references/internationalization.md rename to .agents/skills/build-frontend/references/internationalization.md diff --git a/.agents/skills/codegen-frontend/references/javascript-angular.md b/.agents/skills/build-frontend/references/javascript-angular.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-angular.md rename to .agents/skills/build-frontend/references/javascript-angular.md diff --git a/.agents/skills/codegen-frontend/references/javascript-astro.md b/.agents/skills/build-frontend/references/javascript-astro.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-astro.md rename to .agents/skills/build-frontend/references/javascript-astro.md diff --git a/.agents/skills/codegen-frontend/references/javascript-react-nextjs.md b/.agents/skills/build-frontend/references/javascript-react-nextjs.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-react-nextjs.md rename to .agents/skills/build-frontend/references/javascript-react-nextjs.md diff --git a/.agents/skills/codegen-frontend/references/javascript-react-remix.md b/.agents/skills/build-frontend/references/javascript-react-remix.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-react-remix.md rename to .agents/skills/build-frontend/references/javascript-react-remix.md diff --git a/.agents/skills/codegen-frontend/references/javascript-react.md b/.agents/skills/build-frontend/references/javascript-react.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-react.md rename to .agents/skills/build-frontend/references/javascript-react.md diff --git a/.agents/skills/codegen-frontend/references/javascript-solidjs.md b/.agents/skills/build-frontend/references/javascript-solidjs.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-solidjs.md rename to .agents/skills/build-frontend/references/javascript-solidjs.md diff --git a/.agents/skills/codegen-frontend/references/javascript-svelte-sveltekit.md b/.agents/skills/build-frontend/references/javascript-svelte-sveltekit.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-svelte-sveltekit.md rename to .agents/skills/build-frontend/references/javascript-svelte-sveltekit.md diff --git a/.agents/skills/codegen-frontend/references/javascript-svelte.md b/.agents/skills/build-frontend/references/javascript-svelte.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-svelte.md rename to .agents/skills/build-frontend/references/javascript-svelte.md diff --git a/.agents/skills/codegen-frontend/references/javascript-vue-nuxt.md b/.agents/skills/build-frontend/references/javascript-vue-nuxt.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-vue-nuxt.md rename to .agents/skills/build-frontend/references/javascript-vue-nuxt.md diff --git a/.agents/skills/codegen-frontend/references/javascript-vue.md b/.agents/skills/build-frontend/references/javascript-vue.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript-vue.md rename to .agents/skills/build-frontend/references/javascript-vue.md diff --git a/.agents/skills/codegen-frontend/references/javascript.md b/.agents/skills/build-frontend/references/javascript.md similarity index 100% rename from .agents/skills/codegen-frontend/references/javascript.md rename to .agents/skills/build-frontend/references/javascript.md diff --git a/.agents/skills/codegen-frontend/references/performance.md b/.agents/skills/build-frontend/references/performance.md similarity index 100% rename from .agents/skills/codegen-frontend/references/performance.md rename to .agents/skills/build-frontend/references/performance.md diff --git a/.agents/skills/codegen-frontend/references/pwa.md b/.agents/skills/build-frontend/references/pwa.md similarity index 100% rename from .agents/skills/codegen-frontend/references/pwa.md rename to .agents/skills/build-frontend/references/pwa.md diff --git a/.agents/skills/codegen-frontend/references/state.md b/.agents/skills/build-frontend/references/state.md similarity index 100% rename from .agents/skills/codegen-frontend/references/state.md rename to .agents/skills/build-frontend/references/state.md diff --git a/.agents/skills/codegen-frontend/references/typescript.md b/.agents/skills/build-frontend/references/typescript.md similarity index 100% rename from .agents/skills/codegen-frontend/references/typescript.md rename to .agents/skills/build-frontend/references/typescript.md diff --git a/.agents/skills/codegen-frontend/references/visualization.md b/.agents/skills/build-frontend/references/visualization.md similarity index 100% rename from .agents/skills/codegen-frontend/references/visualization.md rename to .agents/skills/build-frontend/references/visualization.md diff --git a/.agents/skills/creator-rule/SKILL.md b/.agents/skills/create-rule/SKILL.md similarity index 99% rename from .agents/skills/creator-rule/SKILL.md rename to .agents/skills/create-rule/SKILL.md index f7ef356..b1a6a27 100644 --- a/.agents/skills/creator-rule/SKILL.md +++ b/.agents/skills/create-rule/SKILL.md @@ -1,5 +1,5 @@ --- -name: creator-rule +name: create-rule description: Use when writing or improving CLI-agent rules, custom instruction files, AGENTS.md, CLAUDE.md, Cursor rules, Copilot instructions, or modular `.agents/rules/*.md` files. license: MIT version: 1.2.0 @@ -12,7 +12,7 @@ metadata: catalog: utility --- -# creator-rule +# create-rule Write agent rules as durable operating instructions: concise, scoped, concrete, and easy for another agent to apply without guessing. diff --git a/.agents/skills/creator-rule/evals/evals.json b/.agents/skills/create-rule/evals/evals.json similarity index 99% rename from .agents/skills/creator-rule/evals/evals.json rename to .agents/skills/create-rule/evals/evals.json index 1f33795..497cc5f 100644 --- a/.agents/skills/creator-rule/evals/evals.json +++ b/.agents/skills/create-rule/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "creator-rule", + "skill_name": "create-rule", "evals": [ { "id": 1, diff --git a/.agents/skills/creator-rule/scripts/grade_rule_output.py b/.agents/skills/create-rule/scripts/grade_rule_output.py similarity index 97% rename from .agents/skills/creator-rule/scripts/grade_rule_output.py rename to .agents/skills/create-rule/scripts/grade_rule_output.py index e245c86..9ea9884 100644 --- a/.agents/skills/creator-rule/scripts/grade_rule_output.py +++ b/.agents/skills/create-rule/scripts/grade_rule_output.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -"""Heuristic grader for creator-rule output-quality evals. +"""Heuristic grader for create-rule output-quality evals. This script is intentionally deterministic. It does not replace human review or model grading; it catches common failures cheaply: vague rules, missing scoped @@ -25,7 +25,7 @@ ] IMPERATIVE_RE = re.compile( - r"\b(use|run|never|do not|don't|ask|include|update|avoid|prefer|keep|" + r"\b(use|run|never|do not|don't|ask-questions|include|update|avoid|prefer|keep|" r"write|add|check|verify|redact|report|call out|do)\b", re.IGNORECASE, ) @@ -164,7 +164,7 @@ def grade(eval_item: dict, output: str) -> dict: def main() -> int: - parser = argparse.ArgumentParser(description="Grade one creator-rule eval output") + parser = argparse.ArgumentParser(description="Grade one create-rule eval output") parser.add_argument("--eval-id", type=int, required=True, help="Eval id from evals/evals.json") parser.add_argument("--output", required=True, help="Path to the generated rule output") parser.add_argument( diff --git a/.agents/skills/creator-rule/scripts/run_trigger_eval.py b/.agents/skills/create-rule/scripts/run_trigger_eval.py similarity index 96% rename from .agents/skills/creator-rule/scripts/run_trigger_eval.py rename to .agents/skills/create-rule/scripts/run_trigger_eval.py index a2705e1..dc9d2d0 100644 --- a/.agents/skills/creator-rule/scripts/run_trigger_eval.py +++ b/.agents/skills/create-rule/scripts/run_trigger_eval.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -"""Run creator-rule trigger evals. +"""Run create-rule trigger evals. By default this uses a transparent lexical router so the eval set can run offline in CI. Pass --agent-command to test a real CLI/router. The command can @@ -30,7 +30,7 @@ NEGATIVE_PATTERNS = [ r"\b(review this pull request|fix the failing|generate SQL|release notes|user story|technical spec)\b", - r"\b(explain|summarize)\b.*\b(AGENTS\.md|README|coding standards)\b", + r"\b(explain-topic|summarize)\b.*\b(AGENTS\.md|README|coding standards)\b", ] @@ -120,9 +120,9 @@ def agent_router(command_template: str, query: str, skill_name: str, description def main() -> int: - parser = argparse.ArgumentParser(description="Run creator-rule trigger evals") + parser = argparse.ArgumentParser(description="Run create-rule trigger evals") parser.add_argument("--eval-set", default=None, help="Path to trigger-evals.json") - parser.add_argument("--skill-path", default=None, help="Path to creator-rule skill root") + parser.add_argument("--skill-path", default=None, help="Path to create-rule skill root") parser.add_argument("--agent-command", default=None, help="Optional CLI command template for real routing judgment") parser.add_argument("--timeout", type=int, default=30) parser.add_argument("--trials", type=int, default=1, help="Number of repeated runs per query") diff --git a/.agents/skills/creator-rule/scripts/validate_evals.py b/.agents/skills/create-rule/scripts/validate_evals.py similarity index 94% rename from .agents/skills/creator-rule/scripts/validate_evals.py rename to .agents/skills/create-rule/scripts/validate_evals.py index 371543d..b3ed18d 100644 --- a/.agents/skills/creator-rule/scripts/validate_evals.py +++ b/.agents/skills/create-rule/scripts/validate_evals.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -"""Validate creator-rule eval files.""" +"""Validate create-rule eval files.""" from __future__ import annotations @@ -26,8 +26,8 @@ def validate_task_evals(path: Path) -> list[str]: errors: list[str] = [] data = load_json(path) - if data.get("skill_name") != "creator-rule": - errors.append("evals.json skill_name must be creator-rule") + if data.get("skill_name") != "create-rule": + errors.append("evals.json skill_name must be create-rule") evals = data.get("evals") if not isinstance(evals, list) or not evals: @@ -113,7 +113,7 @@ def main() -> int: print(f"ERROR: {error}", file=sys.stderr) return 1 - print("creator-rule eval files are valid") + print("create-rule eval files are valid") return 0 diff --git a/.agents/skills/creator-rule/scripts/validate_rule.py b/.agents/skills/create-rule/scripts/validate_rule.py similarity index 97% rename from .agents/skills/creator-rule/scripts/validate_rule.py rename to .agents/skills/create-rule/scripts/validate_rule.py index 35397cb..129af36 100644 --- a/.agents/skills/creator-rule/scripts/validate_rule.py +++ b/.agents/skills/create-rule/scripts/validate_rule.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -"""Validate creator-rule skill packaging.""" +"""Validate create-rule skill packaging.""" from __future__ import annotations @@ -101,7 +101,7 @@ def main() -> int: print(f"ERROR: {error}", file=sys.stderr) return 1 - print("creator-rule skill is valid") + print("create-rule skill is valid") return 0 diff --git a/.agents/skills/creator-skill/SKILL.md b/.agents/skills/create-skill/SKILL.md similarity index 99% rename from .agents/skills/creator-skill/SKILL.md rename to .agents/skills/create-skill/SKILL.md index a0cbe5f..36b5b62 100644 --- a/.agents/skills/creator-skill/SKILL.md +++ b/.agents/skills/create-skill/SKILL.md @@ -1,5 +1,5 @@ --- -name: creator-skill +name: create-skill description: Use when creating, editing, reviewing, evaluating, packaging, optimizing or improving skills. license: Apache-2.0 version: 1.1.3 @@ -12,7 +12,7 @@ metadata: catalog: utility --- -# creator-skill +# create-skill Create new skills, review and improve existing skills, evaluate outputs, optimize trigger descriptions, and package final skill folders. diff --git a/.agents/skills/creator-skill/agents/analyzer.md b/.agents/skills/create-skill/agents/analyzer.md similarity index 100% rename from .agents/skills/creator-skill/agents/analyzer.md rename to .agents/skills/create-skill/agents/analyzer.md diff --git a/.agents/skills/creator-skill/agents/benchmark-analyzer.md b/.agents/skills/create-skill/agents/benchmark-analyzer.md similarity index 100% rename from .agents/skills/creator-skill/agents/benchmark-analyzer.md rename to .agents/skills/create-skill/agents/benchmark-analyzer.md diff --git a/.agents/skills/creator-skill/agents/comparator.md b/.agents/skills/create-skill/agents/comparator.md similarity index 100% rename from .agents/skills/creator-skill/agents/comparator.md rename to .agents/skills/create-skill/agents/comparator.md diff --git a/.agents/skills/creator-skill/agents/grader.md b/.agents/skills/create-skill/agents/grader.md similarity index 99% rename from .agents/skills/creator-skill/agents/grader.md rename to .agents/skills/create-skill/agents/grader.md index ba7a31e..bfdc726 100644 --- a/.agents/skills/creator-skill/agents/grader.md +++ b/.agents/skills/create-skill/agents/grader.md @@ -214,7 +214,7 @@ Write a JSON file with this structure: - **needs_review**: Items requiring human attention - **workarounds**: Places where the skill didn't work as expected - **eval_feedback**: Improvement suggestions for the evals (only when warranted) - - **suggestions**: List of concrete suggestions, each with a `reason` and optionally an `assertion` it relates to + - **suggestions**: List of concrete suggestions, each with a `reason-problem` and optionally an `assertion` it relates to - **overall**: Brief assessment — can be "No suggestions, evals look solid" if nothing to flag ## Guidelines diff --git a/.agents/skills/creator-skill/assets/eval_review.html b/.agents/skills/create-skill/assets/eval_review.html similarity index 100% rename from .agents/skills/creator-skill/assets/eval_review.html rename to .agents/skills/create-skill/assets/eval_review.html diff --git a/.agents/skills/creator-skill/eval-viewer/generate_review.py b/.agents/skills/create-skill/eval-viewer/generate_review.py similarity index 100% rename from .agents/skills/creator-skill/eval-viewer/generate_review.py rename to .agents/skills/create-skill/eval-viewer/generate_review.py diff --git a/.agents/skills/creator-skill/eval-viewer/viewer.html b/.agents/skills/create-skill/eval-viewer/viewer.html similarity index 100% rename from .agents/skills/creator-skill/eval-viewer/viewer.html rename to .agents/skills/create-skill/eval-viewer/viewer.html diff --git a/.agents/skills/creator-skill/evals/evals.json b/.agents/skills/create-skill/evals/evals.json similarity index 87% rename from .agents/skills/creator-skill/evals/evals.json rename to .agents/skills/create-skill/evals/evals.json index 83581bc..79d07b7 100644 --- a/.agents/skills/creator-skill/evals/evals.json +++ b/.agents/skills/create-skill/evals/evals.json @@ -1,11 +1,11 @@ { - "skill_name": "creator-skill", + "skill_name": "create-skill", "evals": [ { "id": 1, "reference": "references/authoring.md", "prompt": "Create a new skill for incident postmortems with concise SKILL.md and only useful references.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -20,7 +20,7 @@ "id": 2, "reference": "references/authoring.md", "prompt": "Refactor a 7000-token cloud skill into a router without changing capabilities.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -35,7 +35,7 @@ "id": 3, "reference": "references/authoring.md", "prompt": "Create a skill for CSV cleanup with trigger description, workflow, references, and evals.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -50,7 +50,7 @@ "id": 4, "reference": "references/authoring.md", "prompt": "Revise a skill so its frontmatter stays under 100 tokens and the body under 500 lines.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -65,7 +65,7 @@ "id": 5, "reference": "references/authoring.md", "prompt": "Turn a long provider-specific skill into progressive-disclosure references.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -80,7 +80,7 @@ "id": 6, "reference": "references/authoring.md", "prompt": "Create a new skill folder and avoid placeholder scripts/assets/evals.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -95,7 +95,7 @@ "id": 7, "reference": "references/authoring.md", "prompt": "Update a skill to add section delimiters and bold principle sentences.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -110,7 +110,7 @@ "id": 8, "reference": "references/authoring.md", "prompt": "Create a portable skill that avoids runtime-specific slash commands.", - "expected_output": "A response that routes to references/authoring.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/authoring.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to authoring guidance", @@ -125,7 +125,7 @@ "id": 9, "reference": "references/review.md", "prompt": "Review the new agent skill in .agents/skills/data-cleanup before publishing.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -140,7 +140,7 @@ "id": 10, "reference": "references/review.md", "prompt": "Review this skill description: description: Process files.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -154,8 +154,8 @@ { "id": 11, "reference": "references/review.md", - "prompt": "Review a skill for trigger overlap against writer-tech-docs and writer-spec.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "prompt": "Review a skill for trigger overlap against write-tech-docs and write-spec.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -170,7 +170,7 @@ "id": 12, "reference": "references/review.md", "prompt": "Find quality issues in a skill that has stale references and no evals.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -185,7 +185,7 @@ "id": 13, "reference": "references/review.md", "prompt": "Review whether a skill is too broad and should be split into multiple skills.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -200,7 +200,7 @@ "id": 14, "reference": "references/review.md", "prompt": "Review a skill package for hidden credential capture or exfiltration risk.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -215,7 +215,7 @@ "id": 15, "reference": "references/review.md", "prompt": "Review a router skill for missing route instructions and weak output format.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -230,7 +230,7 @@ "id": 16, "reference": "references/review.md", "prompt": "Review a skill after a style-only patch and identify behavioral drift.", - "expected_output": "A response that routes to references/review.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/review.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to review guidance", @@ -245,7 +245,7 @@ "id": 17, "reference": "references/evaluation.md", "prompt": "Generate eval cases for a router skill that writes README, API docs, changelog, release notes, and runbooks.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -260,7 +260,7 @@ "id": 18, "reference": "references/evaluation.md", "prompt": "Create evals for a focused skill that writes incident postmortems.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -275,7 +275,7 @@ "id": 19, "reference": "references/evaluation.md", "prompt": "Build near-miss trigger evals for a database skill versus report-db-health.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -290,7 +290,7 @@ "id": 20, "reference": "references/evaluation.md", "prompt": "Plan an iteration comparing with_skill and without_skill outputs.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -305,7 +305,7 @@ "id": 21, "reference": "references/evaluation.md", "prompt": "Define objective grading assertions for generated SQL migrations.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -320,7 +320,7 @@ "id": 22, "reference": "references/evaluation.md", "prompt": "Aggregate benchmark results from iteration-2 and summarize pass rates.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -335,7 +335,7 @@ "id": 23, "reference": "references/evaluation.md", "prompt": "Create a human review UI for a skill eval run in a headless environment.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -350,7 +350,7 @@ "id": 24, "reference": "references/evaluation.md", "prompt": "Revise eval cases after repeated failures in route selection.", - "expected_output": "A response that routes to references/evaluation.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/evaluation.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to evaluation guidance", @@ -365,7 +365,7 @@ "id": 25, "reference": "references/description-optimization.md", "prompt": "Optimize a skill description for database schemas and SQL queries within budget.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -380,7 +380,7 @@ "id": 26, "reference": "references/description-optimization.md", "prompt": "Improve a trigger description that undertriggers for runbook requests.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -395,7 +395,7 @@ "id": 27, "reference": "references/description-optimization.md", "prompt": "Make a description less broad so it does not trigger on generic file conversion.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -410,7 +410,7 @@ "id": 28, "reference": "references/description-optimization.md", "prompt": "Create should-trigger and should-not-trigger examples for a skill description.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -425,7 +425,7 @@ "id": 29, "reference": "references/description-optimization.md", "prompt": "Shorten an overlong skill description without losing core trigger cues.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -439,8 +439,8 @@ { "id": 30, "reference": "references/description-optimization.md", - "prompt": "Diagnose trigger overlap between writer-prd and writer-spec descriptions.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "prompt": "Diagnose trigger overlap between write-prd and write-spec descriptions.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -455,7 +455,7 @@ "id": 31, "reference": "references/description-optimization.md", "prompt": "Improve a code review skill description for PR, diff, branch, and patch requests.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -470,7 +470,7 @@ "id": 32, "reference": "references/description-optimization.md", "prompt": "Optimize metadata for a router skill without stuffing every route keyword.", - "expected_output": "A response that routes to references/description-optimization.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/description-optimization.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to description optimization guidance", @@ -485,7 +485,7 @@ "id": 33, "reference": "references/agent-compatibility.md", "prompt": "Adapt a skill workflow for a generic CLI agent without subagents.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -500,7 +500,7 @@ "id": 34, "reference": "references/agent-compatibility.md", "prompt": "Port a skill that mentions Claude Code commands to runtime-neutral instructions.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -515,7 +515,7 @@ "id": 35, "reference": "references/agent-compatibility.md", "prompt": "Document compatibility notes for a skill that uses local scripts.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -530,7 +530,7 @@ "id": 36, "reference": "references/agent-compatibility.md", "prompt": "Adjust a skill so Browser plugin instructions are isolated from core workflow.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -545,7 +545,7 @@ "id": 37, "reference": "references/agent-compatibility.md", "prompt": "Make a skill usable in agents that cannot spawn helper agents.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -560,7 +560,7 @@ "id": 38, "reference": "references/agent-compatibility.md", "prompt": "Replace runtime-specific tool names with portable action descriptions.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -575,7 +575,7 @@ "id": 39, "reference": "references/agent-compatibility.md", "prompt": "Review a skill for assumptions about event streams and UI affordances.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", @@ -590,7 +590,7 @@ "id": 40, "reference": "references/agent-compatibility.md", "prompt": "Write compatibility guidance for packaging and validation in another CLI runtime.", - "expected_output": "A response that routes to references/agent-compatibility.md and applies the creator-skill workflow for the requested task.", + "expected_output": "A response that routes to references/agent-compatibility.md and applies the create-skill workflow for the requested task.", "files": [], "expectations": [ "Routes to compatibility guidance", diff --git a/.agents/skills/creator-skill/references/agent-compatibility.md b/.agents/skills/create-skill/references/agent-compatibility.md similarity index 100% rename from .agents/skills/creator-skill/references/agent-compatibility.md rename to .agents/skills/create-skill/references/agent-compatibility.md diff --git a/.agents/skills/creator-skill/references/authoring.md b/.agents/skills/create-skill/references/authoring.md similarity index 94% rename from .agents/skills/creator-skill/references/authoring.md rename to .agents/skills/create-skill/references/authoring.md index 259dd42..7ba9336 100644 --- a/.agents/skills/creator-skill/references/authoring.md +++ b/.agents/skills/create-skill/references/authoring.md @@ -45,7 +45,7 @@ Apply the house Markdown style while writing, not as a later cleanup pass: - **Rule bullets**: use bold labels as scan anchors when each bullet is a distinct rule. - **Template exceptions**: do not force bold labels into schemas, command examples, literal output templates, or checklist items where they would make the example less accurate. -After editing, run `creator-skill/scripts/quick_validate.py ` when this skill's scripts are available. Treat style failures as authoring bugs, not optional polish. +After editing, run `create-skill/scripts/quick_validate.py ` when this skill's scripts are available. Treat style failures as authoring bugs, not optional polish. For router skills with `references/*.md`, create `evals/evals.json` before validation is considered complete. Each eval must include a `reference` field that points to the routed reference, and every non-schema reference must have 8-10 evals. This keeps the router honest instead of giving it one polite smoke test and hoping for the best. @@ -79,7 +79,7 @@ Do not create placeholder directories. Add a folder only when it contains useful Use three levels: metadata loaded by the runtime, main body loaded when the skill triggers, and bundled resources loaded only when needed. -Router skills should classify the request, choose the relevant reference, read only that reference, and act. +Router skills should classify-content the request, choose the relevant reference, read only that reference, and act. ## Compatibility diff --git a/.agents/skills/creator-skill/references/description-optimization.md b/.agents/skills/create-skill/references/description-optimization.md similarity index 96% rename from .agents/skills/creator-skill/references/description-optimization.md rename to .agents/skills/create-skill/references/description-optimization.md index 1c7703f..ad438ba 100644 --- a/.agents/skills/creator-skill/references/description-optimization.md +++ b/.agents/skills/create-skill/references/description-optimization.md @@ -2,7 +2,7 @@ Use this reference when optimizing a skill's frontmatter description for trigger accuracy. -The `description` field is the main signal native skill runtimes use to decide whether to invoke a skill. Optimize it after the skill behavior is stable. +The `description` field is the main signal native skill runtimes use to decide-direction whether to invoke a skill. Optimize it after the skill behavior is stable. ## Choose the Agent Adapter diff --git a/.agents/skills/creator-skill/references/evaluation.md b/.agents/skills/create-skill/references/evaluation.md similarity index 100% rename from .agents/skills/creator-skill/references/evaluation.md rename to .agents/skills/create-skill/references/evaluation.md diff --git a/.agents/skills/creator-skill/references/review.md b/.agents/skills/create-skill/references/review.md similarity index 95% rename from .agents/skills/creator-skill/references/review.md rename to .agents/skills/create-skill/references/review.md index b3b0fb3..1177652 100644 --- a/.agents/skills/creator-skill/references/review.md +++ b/.agents/skills/create-skill/references/review.md @@ -12,7 +12,7 @@ Check whether the frontmatter `description` is a useful trigger signal. - **Trigger contexts**: name the core user intents and strongest trigger contexts. Be proactive when the skill applies even if the user does not name the domain directly, such as when they omit an obvious domain keyword. - **Near misses**: avoid broad keyword stuffing that would trigger on adjacent tasks the skill does not actually handle. - **Hard limit**: stay under the **1024-character hard limit** enforced by the spec. Check the character count directly; detailed routing, exclusions, and examples belong in the body or references. -- **Skill value**: remember that agents tend to reach for skills only when a task requires knowledge or capabilities beyond what they can handle alone. Weight eval queries toward specialized knowledge, unfamiliar APIs, or domain-specific workflows. +- **Skill value**: remember-context that agents tend to reach for skills only when a task requires knowledge or capabilities beyond what they can handle alone. Weight eval queries toward specialized knowledge, unfamiliar APIs, or domain-specific workflows. - **Trigger evals**: check for realistic should-trigger and should-not-trigger prompts. Strong should-trigger cases are ones where the skill would help but the connection is not obvious; strong should-not-trigger cases are near misses. Vary phrasing, explicitness, detail level, and complexity. ## Scope And Coherence diff --git a/.agents/skills/creator-skill/references/schemas.md b/.agents/skills/create-skill/references/schemas.md similarity index 100% rename from .agents/skills/creator-skill/references/schemas.md rename to .agents/skills/create-skill/references/schemas.md diff --git a/.agents/skills/codegen-test/scripts/__init__.py b/.agents/skills/create-skill/scripts/__init__.py similarity index 100% rename from .agents/skills/codegen-test/scripts/__init__.py rename to .agents/skills/create-skill/scripts/__init__.py diff --git a/.agents/skills/codegen-test/scripts/agent_runner.py b/.agents/skills/create-skill/scripts/agent_runner.py similarity index 100% rename from .agents/skills/codegen-test/scripts/agent_runner.py rename to .agents/skills/create-skill/scripts/agent_runner.py diff --git a/.agents/skills/codegen-test/scripts/aggregate_benchmark.py b/.agents/skills/create-skill/scripts/aggregate_benchmark.py similarity index 100% rename from .agents/skills/codegen-test/scripts/aggregate_benchmark.py rename to .agents/skills/create-skill/scripts/aggregate_benchmark.py diff --git a/.agents/skills/codegen-test/scripts/generate_report.py b/.agents/skills/create-skill/scripts/generate_report.py similarity index 100% rename from .agents/skills/codegen-test/scripts/generate_report.py rename to .agents/skills/create-skill/scripts/generate_report.py diff --git a/.agents/skills/codegen-test/scripts/improve_description.py b/.agents/skills/create-skill/scripts/improve_description.py similarity index 100% rename from .agents/skills/codegen-test/scripts/improve_description.py rename to .agents/skills/create-skill/scripts/improve_description.py diff --git a/.agents/skills/creator-skill/scripts/package_skill.py b/.agents/skills/create-skill/scripts/package_skill.py similarity index 100% rename from .agents/skills/creator-skill/scripts/package_skill.py rename to .agents/skills/create-skill/scripts/package_skill.py diff --git a/.agents/skills/creator-skill/scripts/quick_validate.py b/.agents/skills/create-skill/scripts/quick_validate.py similarity index 100% rename from .agents/skills/creator-skill/scripts/quick_validate.py rename to .agents/skills/create-skill/scripts/quick_validate.py diff --git a/.agents/skills/codegen-test/scripts/run_eval.py b/.agents/skills/create-skill/scripts/run_eval.py similarity index 100% rename from .agents/skills/codegen-test/scripts/run_eval.py rename to .agents/skills/create-skill/scripts/run_eval.py diff --git a/.agents/skills/codegen-test/scripts/run_loop.py b/.agents/skills/create-skill/scripts/run_loop.py similarity index 100% rename from .agents/skills/codegen-test/scripts/run_loop.py rename to .agents/skills/create-skill/scripts/run_loop.py diff --git a/.agents/skills/codegen-test/scripts/utils.py b/.agents/skills/create-skill/scripts/utils.py similarity index 100% rename from .agents/skills/codegen-test/scripts/utils.py rename to .agents/skills/create-skill/scripts/utils.py diff --git a/.agents/skills/creator-rule/evals/trigger-evals.json b/.agents/skills/creator-rule/evals/trigger-evals.json deleted file mode 100644 index badf9f5..0000000 --- a/.agents/skills/creator-rule/evals/trigger-evals.json +++ /dev/null @@ -1,102 +0,0 @@ -[ - { - "query": "Write a `.agents/rules/testing.md` file for our Python project using pytest and ruff.", - "should_trigger": true, - "split": "train" - }, - { - "query": "Create a CLI-agent rule that tells agents never to edit generated protobuf files.", - "should_trigger": true, - "split": "train" - }, - { - "query": "Improve this AGENTS.md instruction: 'test stuff before done.'", - "should_trigger": true, - "split": "train" - }, - { - "query": "Draft a Claude Code rule for files under `services/billing/**`.", - "should_trigger": true, - "split": "train" - }, - { - "query": "Make a Cursor rule for React components in `apps/web/src/components/**`.", - "should_trigger": true, - "split": "train" - }, - { - "query": "Write GitHub Copilot custom instructions for a Go monorepo.", - "should_trigger": true, - "split": "validation" - }, - { - "query": "Turn our security policy into concise agent instructions for handling secrets.", - "should_trigger": true, - "split": "validation" - }, - { - "query": "Create a path-scoped rule for Terraform under `infra/**`.", - "should_trigger": true, - "split": "validation" - }, - { - "query": "Convert our README's generated-code policy into an agent rule for `clients/**`.", - "should_trigger": true, - "split": "validation" - }, - { - "query": "Add repo instructions for agents so frontend changes use design tokens and include screenshot notes.", - "should_trigger": true, - "split": "validation" - }, - { - "query": "Review this pull request for bugs and regressions.", - "should_trigger": false, - "split": "train" - }, - { - "query": "Write a technical spec for OAuth login.", - "should_trigger": false, - "split": "train" - }, - { - "query": "Create a user story with acceptance criteria for password reset.", - "should_trigger": false, - "split": "train" - }, - { - "query": "Generate SQL to find inactive customers.", - "should_trigger": false, - "split": "train" - }, - { - "query": "Explain what AGENTS.md is and how it loads in Codex.", - "should_trigger": false, - "split": "train" - }, - { - "query": "Summarize the coding standards in this README.", - "should_trigger": false, - "split": "validation" - }, - { - "query": "Fix the failing TypeScript tests.", - "should_trigger": false, - "split": "validation" - }, - { - "query": "Write release notes for version 1.4.0.", - "should_trigger": false, - "split": "validation" - }, - { - "query": "Make the code follow our existing style guide.", - "should_trigger": false, - "split": "validation" - }, - { - "query": "Add a README section explaining our package boundaries to new developers.", - "should_trigger": false, - "split": "validation" - } -] diff --git a/.agents/skills/operator-git/SKILL.md b/.agents/skills/manage-git/SKILL.md similarity index 98% rename from .agents/skills/operator-git/SKILL.md rename to .agents/skills/manage-git/SKILL.md index 27c200c..c4aece6 100644 --- a/.agents/skills/operator-git/SKILL.md +++ b/.agents/skills/manage-git/SKILL.md @@ -1,5 +1,5 @@ --- -name: operator-git +name: manage-git description: > Handle Git branch naming, branch actions, commit-message drafting, and committing staged changes. Use for Git workflow tasks, branch review, commit requests, and diffs needing commit messages. @@ -14,7 +14,7 @@ metadata: catalog: utility --- -# operator-git +# manage-git A **router** skill for Git workflow conventions. First classify the request as either an output workflow or an action workflow, then load the relevant convention reference. diff --git a/.agents/skills/operator-git/evals/evals.json b/.agents/skills/manage-git/evals/evals.json similarity index 99% rename from .agents/skills/operator-git/evals/evals.json rename to .agents/skills/manage-git/evals/evals.json index bce2b08..34e2e10 100644 --- a/.agents/skills/operator-git/evals/evals.json +++ b/.agents/skills/manage-git/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "operator-git", + "skill_name": "manage-git", "evals": [ { "id": 1, diff --git a/.agents/skills/operator-git/references/branch-naming.md b/.agents/skills/manage-git/references/branch-naming.md similarity index 100% rename from .agents/skills/operator-git/references/branch-naming.md rename to .agents/skills/manage-git/references/branch-naming.md diff --git a/.agents/skills/operator-git/references/commit-message.md b/.agents/skills/manage-git/references/commit-message.md similarity index 100% rename from .agents/skills/operator-git/references/commit-message.md rename to .agents/skills/manage-git/references/commit-message.md diff --git a/.agents/skills/operator-git/evals/scripts/check_contract.py b/.agents/skills/operator-git/evals/scripts/check_contract.py deleted file mode 100644 index 055e95b..0000000 --- a/.agents/skills/operator-git/evals/scripts/check_contract.py +++ /dev/null @@ -1,91 +0,0 @@ -#!/usr/bin/env python3 -"""Static contract checks for the operator-git skill.""" - -from __future__ import annotations - -import json -import re -from pathlib import Path - - -ROOT = Path(__file__).resolve().parents[1] -SKILL = ROOT.parent / "SKILL.md" -BRANCH = ROOT.parent / "references" / "branch-naming.md" -COMMIT = ROOT.parent / "references" / "commit-message.md" -TRIGGER_EVALS = ROOT / "trigger-evals.json" - - -def read(path: Path) -> str: - return path.read_text(encoding="utf-8") - - -def check(condition: bool, message: str, evidence: str) -> dict: - return { - "text": message, - "passed": bool(condition), - "evidence": evidence, - } - - -def main() -> int: - skill = read(SKILL) - branch = read(BRANCH) - commit = read(COMMIT) - trigger_evals = json.loads(TRIGGER_EVALS.read_text(encoding="utf-8")) - - expectations = [ - check( - "### Output workflow" in skill and "### Action workflow" in skill, - "SKILL.md defines both output and action workflow types", - "Found both workflow headings in SKILL.md", - ), - check( - "return only the requested artifact" in skill and "Do not wrap generated artifacts" in skill, - "Output workflows require artifact-only responses", - "Found artifact-only and no-wrapper instructions in SKILL.md", - ), - check( - "do not add extra explanatory output" in skill, - "Action workflows suppress extra narrative on success", - "Found successful-action quiet-output instruction in SKILL.md", - ), - check( - "`references/branch-naming.md`" in skill and "`references/commit-message.md`" in skill, - "Router points to both convention references", - "Found both reference paths in the routing table", - ), - check( - "Output vs Action Behavior" not in branch and "Output vs Action Behavior" not in commit, - "Shared output/action behavior is not duplicated in references", - "The duplicate heading is absent from branch and commit references", - ), - check( - bool(re.search(r"`git switch -c `", branch)), - "Branch action guidance prefers git switch -c for creation", - "Found git switch -c guidance in branch-naming.md", - ), - check( - len(trigger_evals) >= 16 - and any(item["should_trigger"] for item in trigger_evals) - and any(not item["should_trigger"] for item in trigger_evals), - "Trigger evals cover both positive and negative routing cases", - f"Found {len(trigger_evals)} trigger evals", - ), - ] - - passed = sum(1 for item in expectations if item["passed"]) - result = { - "expectations": expectations, - "summary": { - "passed": passed, - "failed": len(expectations) - passed, - "total": len(expectations), - "pass_rate": passed / len(expectations), - }, - } - print(json.dumps(result, indent=2)) - return 0 if passed == len(expectations) else 1 - - -if __name__ == "__main__": - raise SystemExit(main()) diff --git a/.agents/skills/operator-git/evals/trigger-evals.json b/.agents/skills/operator-git/evals/trigger-evals.json deleted file mode 100644 index 64b6417..0000000 --- a/.agents/skills/operator-git/evals/trigger-evals.json +++ /dev/null @@ -1,66 +0,0 @@ -[ - { - "query": "Give me a branch name for the docs update I just made to the install guide.", - "should_trigger": true - }, - { - "query": "Create a branch for this bugfix. The login form redirects to /home even when auth fails.", - "should_trigger": true - }, - { - "query": "Review this branch name: Feature/Login Redirect Fix", - "should_trigger": true - }, - { - "query": "Write a commit message for the staged changes.", - "should_trigger": true - }, - { - "query": "Commit the staged changes using our normal commit message format.", - "should_trigger": true - }, - { - "query": "I pasted a git diff below. Give me a conventional commit message for it.", - "should_trigger": true - }, - { - "query": "Start a hotfix branch for the production payment timeout.", - "should_trigger": true - }, - { - "query": "Improve this commit message: stuff", - "should_trigger": true - }, - { - "query": "Explain what a Git branch is to someone who has never used version control.", - "should_trigger": false - }, - { - "query": "How do I undo the last commit but keep the files in my working tree?", - "should_trigger": false - }, - { - "query": "Run git status and tell me what files changed.", - "should_trigger": false - }, - { - "query": "Write release notes from these commits.", - "should_trigger": false - }, - { - "query": "Review this pull request for bugs and security issues.", - "should_trigger": false - }, - { - "query": "Create a README section that explains our branching strategy.", - "should_trigger": false - }, - { - "query": "Squash these commits conceptually and explain the final change set.", - "should_trigger": false - }, - { - "query": "What does this commit hash point to?", - "should_trigger": false - } -] diff --git a/.agents/skills/review-code/evals/evals.json b/.agents/skills/review-code/evals/evals.json index 4b5a5cd..4500a37 100644 --- a/.agents/skills/review-code/evals/evals.json +++ b/.agents/skills/review-code/evals/evals.json @@ -178,7 +178,7 @@ "Recognizes this is a skill-authoring request, not a review request.", "Does not produce severity-ranked review findings by default.", "Routes to the skill-creation workflow.", - "Mentions creator-skill review only if the user later asks to review the created skill." + "Mentions create-skill review only if the user later asks to review the created skill." ] } ] diff --git a/.agents/skills/writer-prd/SKILL.md b/.agents/skills/write-prd/SKILL.md similarity index 99% rename from .agents/skills/writer-prd/SKILL.md rename to .agents/skills/write-prd/SKILL.md index b940793..4ca471e 100644 --- a/.agents/skills/writer-prd/SKILL.md +++ b/.agents/skills/write-prd/SKILL.md @@ -1,5 +1,5 @@ --- -name: writer-prd +name: write-prd description: Use whenever the user asks to write or revise a PRD, product requirements, product brief, feature requirements, product scope, launch requirements. license: MIT version: 1.1.0 @@ -12,7 +12,7 @@ metadata: catalog: software-team-roles --- -# writer-prd +# write-prd Produce a complete, structured **Product Requirements Document (PRD)** for the described product, feature, or initiative. diff --git a/.agents/skills/writer-prd/evals/evals.json b/.agents/skills/write-prd/evals/evals.json similarity index 99% rename from .agents/skills/writer-prd/evals/evals.json rename to .agents/skills/write-prd/evals/evals.json index 9a1db10..fcc1a56 100644 --- a/.agents/skills/writer-prd/evals/evals.json +++ b/.agents/skills/write-prd/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "writer-prd", + "skill_name": "write-prd", "evals": [ { "id": 1, diff --git a/.agents/skills/writer-prd/references/examples.md b/.agents/skills/write-prd/references/examples.md similarity index 100% rename from .agents/skills/writer-prd/references/examples.md rename to .agents/skills/write-prd/references/examples.md diff --git a/.agents/skills/writer-prd/references/output-format.md b/.agents/skills/write-prd/references/output-format.md similarity index 100% rename from .agents/skills/writer-prd/references/output-format.md rename to .agents/skills/write-prd/references/output-format.md diff --git a/.agents/skills/writer-spec/SKILL.md b/.agents/skills/write-spec/SKILL.md similarity index 97% rename from .agents/skills/writer-spec/SKILL.md rename to .agents/skills/write-spec/SKILL.md index 6af8c62..798f448 100644 --- a/.agents/skills/writer-spec/SKILL.md +++ b/.agents/skills/write-spec/SKILL.md @@ -1,5 +1,5 @@ --- -name: writer-spec +name: write-spec description: > Write product specifications and requirements documents. Use for tech specs, design docs, TDDs, functional or non-functional requirements, data contracts, UI specs, release specs, @@ -15,7 +15,7 @@ metadata: catalog: software-team-roles --- -# writer-spec +# write-spec A **router** skill to generate specific product specification document types. Identify user intent, select the matching spec type, and produce the document using its reference format. For ambiguous or multi-type requests, combine sections and note the merged types. @@ -25,7 +25,7 @@ A **router** skill to generate specific product specification document types. Id A strong product specification aligns the team on what is being built, why it matters, how the customer will use it, and how success will be measured. It should reduce ambiguity, feature creep, delays, and cross-functional disagreement by making responsibilities, scope, design, test plans, release work, and ongoing management explicit. -When product intent is missing, ask for or infer it before writing technical detail. If the user needs product purpose, personas, market context, or success metrics more than delivery detail, route them to `writer-prd` first or state the assumptions clearly. +When product intent is missing, ask for or infer it before writing technical detail. If the user needs product purpose, personas, market context, or success metrics more than delivery detail, route them to `write-prd` first or state the assumptions clearly. ## Routing Table diff --git a/.agents/skills/writer-spec/evals/evals.json b/.agents/skills/write-spec/evals/evals.json similarity index 99% rename from .agents/skills/writer-spec/evals/evals.json rename to .agents/skills/write-spec/evals/evals.json index b65c2db..ccad439 100644 --- a/.agents/skills/writer-spec/evals/evals.json +++ b/.agents/skills/write-spec/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "writer-spec", + "skill_name": "write-spec", "evals": [ { "id": 1, diff --git a/.agents/skills/writer-spec/references/data-contract.md b/.agents/skills/write-spec/references/data-contract.md similarity index 100% rename from .agents/skills/writer-spec/references/data-contract.md rename to .agents/skills/write-spec/references/data-contract.md diff --git a/.agents/skills/writer-spec/references/design-ui.md b/.agents/skills/write-spec/references/design-ui.md similarity index 100% rename from .agents/skills/writer-spec/references/design-ui.md rename to .agents/skills/write-spec/references/design-ui.md diff --git a/.agents/skills/writer-spec/references/functional.md b/.agents/skills/write-spec/references/functional.md similarity index 100% rename from .agents/skills/writer-spec/references/functional.md rename to .agents/skills/write-spec/references/functional.md diff --git a/.agents/skills/writer-spec/references/non-functional.md b/.agents/skills/write-spec/references/non-functional.md similarity index 100% rename from .agents/skills/writer-spec/references/non-functional.md rename to .agents/skills/write-spec/references/non-functional.md diff --git a/.agents/skills/writer-spec/references/technical.md b/.agents/skills/write-spec/references/technical.md similarity index 100% rename from .agents/skills/writer-spec/references/technical.md rename to .agents/skills/write-spec/references/technical.md diff --git a/.agents/skills/writer-tech-docs/SKILL.md b/.agents/skills/write-tech-docs/SKILL.md similarity index 96% rename from .agents/skills/writer-tech-docs/SKILL.md rename to .agents/skills/write-tech-docs/SKILL.md index 8e82727..74d407c 100644 --- a/.agents/skills/writer-tech-docs/SKILL.md +++ b/.agents/skills/write-tech-docs/SKILL.md @@ -1,5 +1,5 @@ --- -name: writer-tech-docs +name: write-tech-docs description: > Write technical docs. Use for READMEs, API docs, endpoint references, routine or on-call runbooks, operational procedures, changelogs, and release notes. Use for operational, @@ -15,7 +15,7 @@ metadata: catalog: software-team-roles --- -# writer-tech-docs +# write-tech-docs Router skill that dispatches to the correct technical documentation variant. @@ -34,7 +34,7 @@ Check in this order: - `on-call` / `alert` / `pagerduty` / `incident response` — runbook-oncall variant - `changelog` / `keep a changelog` / `CHANGELOG` — changelog variant - `release notes` / `what's new` / `version announcement` — release-notes variant -4. **If still ambiguous**: ask the user once with the list of variants +4. **If still ambiguous**: ask-questions the user once with the list of variants ## Variants diff --git a/.agents/skills/writer-tech-docs/evals/evals.json b/.agents/skills/write-tech-docs/evals/evals.json similarity index 99% rename from .agents/skills/writer-tech-docs/evals/evals.json rename to .agents/skills/write-tech-docs/evals/evals.json index 3d933a8..b76b444 100644 --- a/.agents/skills/writer-tech-docs/evals/evals.json +++ b/.agents/skills/write-tech-docs/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "writer-tech-docs", + "skill_name": "write-tech-docs", "evals": [ { "id": 1, diff --git a/.agents/skills/writer-tech-docs/references/api-docs.md b/.agents/skills/write-tech-docs/references/api-docs.md similarity index 99% rename from .agents/skills/writer-tech-docs/references/api-docs.md rename to .agents/skills/write-tech-docs/references/api-docs.md index d66598f..63c4d11 100644 --- a/.agents/skills/writer-tech-docs/references/api-docs.md +++ b/.agents/skills/write-tech-docs/references/api-docs.md @@ -1,4 +1,4 @@ -# writer-tech-docs — api-docs variant +# write-tech-docs — api-docs variant Produce **API reference documentation** for existing endpoints, ready for a developer portal or README. diff --git a/.agents/skills/writer-tech-docs/references/changelog.md b/.agents/skills/write-tech-docs/references/changelog.md similarity index 99% rename from .agents/skills/writer-tech-docs/references/changelog.md rename to .agents/skills/write-tech-docs/references/changelog.md index acae817..27e45d0 100644 --- a/.agents/skills/writer-tech-docs/references/changelog.md +++ b/.agents/skills/write-tech-docs/references/changelog.md @@ -1,4 +1,4 @@ -# writer-tech-docs — changelog variant +# write-tech-docs — changelog variant Produce a **developer changelog** in Keep a Changelog format, grouped by change type. diff --git a/.agents/skills/writer-tech-docs/references/readme.md b/.agents/skills/write-tech-docs/references/readme.md similarity index 98% rename from .agents/skills/writer-tech-docs/references/readme.md rename to .agents/skills/write-tech-docs/references/readme.md index f04a8d1..f5c1a86 100644 --- a/.agents/skills/writer-tech-docs/references/readme.md +++ b/.agents/skills/write-tech-docs/references/readme.md @@ -1,4 +1,4 @@ -# writer-tech-docs — readme variant +# write-tech-docs — readme variant Produce a **complete, professional README.md** that gives any reader everything they need to understand, install, and use the project. diff --git a/.agents/skills/writer-tech-docs/references/release-notes.md b/.agents/skills/write-tech-docs/references/release-notes.md similarity index 98% rename from .agents/skills/writer-tech-docs/references/release-notes.md rename to .agents/skills/write-tech-docs/references/release-notes.md index ae6545e..53d803e 100644 --- a/.agents/skills/writer-tech-docs/references/release-notes.md +++ b/.agents/skills/write-tech-docs/references/release-notes.md @@ -1,4 +1,4 @@ -# writer-tech-docs — release-notes variant +# write-tech-docs — release-notes variant Produce **user-facing release notes** that communicate new features, improvements, fixes, and upgrade guidance. diff --git a/.agents/skills/writer-tech-docs/references/runbook-oncall.md b/.agents/skills/write-tech-docs/references/runbook-oncall.md similarity index 99% rename from .agents/skills/writer-tech-docs/references/runbook-oncall.md rename to .agents/skills/write-tech-docs/references/runbook-oncall.md index a3f4218..0da1cfc 100644 --- a/.agents/skills/writer-tech-docs/references/runbook-oncall.md +++ b/.agents/skills/write-tech-docs/references/runbook-oncall.md @@ -1,4 +1,4 @@ -# writer-tech-docs — runbook-oncall variant +# write-tech-docs — runbook-oncall variant Produce an **on-call alert runbook** with symptoms, diagnosis steps, escalation paths, and resolution procedures. diff --git a/.agents/skills/writer-tech-docs/references/runbook-routine.md b/.agents/skills/write-tech-docs/references/runbook-routine.md similarity index 98% rename from .agents/skills/writer-tech-docs/references/runbook-routine.md rename to .agents/skills/write-tech-docs/references/runbook-routine.md index 45c770f..f833755 100644 --- a/.agents/skills/writer-tech-docs/references/runbook-routine.md +++ b/.agents/skills/write-tech-docs/references/runbook-routine.md @@ -1,4 +1,4 @@ -# writer-tech-docs — runbook-routine variant +# write-tech-docs — runbook-routine variant Produce a **general operational runbook** with clear steps, prerequisites, verification, and rollback procedures. diff --git a/.agents/skills/codegen-test/SKILL.md b/.agents/skills/write-tests/SKILL.md similarity index 99% rename from .agents/skills/codegen-test/SKILL.md rename to .agents/skills/write-tests/SKILL.md index 9317f12..59cce66 100644 --- a/.agents/skills/codegen-test/SKILL.md +++ b/.agents/skills/write-tests/SKILL.md @@ -1,5 +1,5 @@ --- -name: codegen-test +name: write-tests description: > Generate or revise automated tests and evals. Use for E2E/browser, API/contract, integration, load/performance, LLM output, RAG, prompt regression, AI tool-use, @@ -15,7 +15,7 @@ metadata: catalog: software-team-roles --- -# codegen-test +# write-tests Generate production-ready test code and evaluation suites. Classify the request, read the matching reference, inspect the repository, then implement runnable tests or provide complete files when direct edits are not safe. diff --git a/.agents/skills/codegen-test/evals/evals.json b/.agents/skills/write-tests/evals/evals.json similarity index 99% rename from .agents/skills/codegen-test/evals/evals.json rename to .agents/skills/write-tests/evals/evals.json index 91a875c..61692e7 100644 --- a/.agents/skills/codegen-test/evals/evals.json +++ b/.agents/skills/write-tests/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "codegen-test", + "skill_name": "write-tests", "evals": [ { "id": 1, diff --git a/.agents/skills/codegen-test/references/ai-output.md b/.agents/skills/write-tests/references/ai-output.md similarity index 100% rename from .agents/skills/codegen-test/references/ai-output.md rename to .agents/skills/write-tests/references/ai-output.md diff --git a/.agents/skills/codegen-test/references/ai-perf.md b/.agents/skills/write-tests/references/ai-perf.md similarity index 98% rename from .agents/skills/codegen-test/references/ai-perf.md rename to .agents/skills/write-tests/references/ai-perf.md index 717048c..ff5321d 100644 --- a/.agents/skills/codegen-test/references/ai-perf.md +++ b/.agents/skills/write-tests/references/ai-perf.md @@ -65,7 +65,7 @@ Use thresholds that match the product experience: - **RAG answer:** Retrieval latency, generation latency, grounded-answer pass rate, and cost per grounded answer. - **Tool-using agent:** Max model calls, max tool calls, task completion rate, and cost per completed task. -Avoid average-only gates. Averages hide the one slow path that users remember with surprising emotional clarity. +Avoid average-only gates. Averages hide the one slow path that users remember-context with surprising emotional clarity. ## Runner Pattern diff --git a/.agents/skills/codegen-test/references/ai-tool-use.md b/.agents/skills/write-tests/references/ai-tool-use.md similarity index 100% rename from .agents/skills/codegen-test/references/ai-tool-use.md rename to .agents/skills/write-tests/references/ai-tool-use.md diff --git a/.agents/skills/codegen-test/references/api.md b/.agents/skills/write-tests/references/api.md similarity index 100% rename from .agents/skills/codegen-test/references/api.md rename to .agents/skills/write-tests/references/api.md diff --git a/.agents/skills/codegen-test/references/e2e.md b/.agents/skills/write-tests/references/e2e.md similarity index 100% rename from .agents/skills/codegen-test/references/e2e.md rename to .agents/skills/write-tests/references/e2e.md diff --git a/.agents/skills/codegen-test/references/perf.md b/.agents/skills/write-tests/references/perf.md similarity index 100% rename from .agents/skills/codegen-test/references/perf.md rename to .agents/skills/write-tests/references/perf.md diff --git a/.agents/skills/creator-skill/scripts/__init__.py b/.agents/skills/write-tests/scripts/__init__.py similarity index 100% rename from .agents/skills/creator-skill/scripts/__init__.py rename to .agents/skills/write-tests/scripts/__init__.py diff --git a/.agents/skills/creator-skill/scripts/agent_runner.py b/.agents/skills/write-tests/scripts/agent_runner.py similarity index 100% rename from .agents/skills/creator-skill/scripts/agent_runner.py rename to .agents/skills/write-tests/scripts/agent_runner.py diff --git a/.agents/skills/creator-skill/scripts/aggregate_benchmark.py b/.agents/skills/write-tests/scripts/aggregate_benchmark.py similarity index 100% rename from .agents/skills/creator-skill/scripts/aggregate_benchmark.py rename to .agents/skills/write-tests/scripts/aggregate_benchmark.py diff --git a/.agents/skills/creator-skill/scripts/generate_report.py b/.agents/skills/write-tests/scripts/generate_report.py similarity index 100% rename from .agents/skills/creator-skill/scripts/generate_report.py rename to .agents/skills/write-tests/scripts/generate_report.py diff --git a/.agents/skills/creator-skill/scripts/improve_description.py b/.agents/skills/write-tests/scripts/improve_description.py similarity index 100% rename from .agents/skills/creator-skill/scripts/improve_description.py rename to .agents/skills/write-tests/scripts/improve_description.py diff --git a/.agents/skills/creator-skill/scripts/run_eval.py b/.agents/skills/write-tests/scripts/run_eval.py similarity index 100% rename from .agents/skills/creator-skill/scripts/run_eval.py rename to .agents/skills/write-tests/scripts/run_eval.py diff --git a/.agents/skills/creator-skill/scripts/run_loop.py b/.agents/skills/write-tests/scripts/run_loop.py similarity index 100% rename from .agents/skills/creator-skill/scripts/run_loop.py rename to .agents/skills/write-tests/scripts/run_loop.py diff --git a/.agents/skills/codegen-test/scripts/scaffold_ai_eval.py b/.agents/skills/write-tests/scripts/scaffold_ai_eval.py similarity index 99% rename from .agents/skills/codegen-test/scripts/scaffold_ai_eval.py rename to .agents/skills/write-tests/scripts/scaffold_ai_eval.py index ba9bd9b..c7415a2 100644 --- a/.agents/skills/codegen-test/scripts/scaffold_ai_eval.py +++ b/.agents/skills/write-tests/scripts/scaffold_ai_eval.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -"""Scaffold AI eval fixtures for codegen-test users.""" +"""Scaffold AI eval fixtures for write-tests users.""" from __future__ import annotations diff --git a/.agents/skills/codegen-test/scripts/summarize_ai_perf.py b/.agents/skills/write-tests/scripts/summarize_ai_perf.py similarity index 100% rename from .agents/skills/codegen-test/scripts/summarize_ai_perf.py rename to .agents/skills/write-tests/scripts/summarize_ai_perf.py diff --git a/.agents/skills/creator-skill/scripts/utils.py b/.agents/skills/write-tests/scripts/utils.py similarity index 100% rename from .agents/skills/creator-skill/scripts/utils.py rename to .agents/skills/write-tests/scripts/utils.py diff --git a/.agents/skills/codegen-test/scripts/validate_evals.py b/.agents/skills/write-tests/scripts/validate_evals.py similarity index 96% rename from .agents/skills/codegen-test/scripts/validate_evals.py rename to .agents/skills/write-tests/scripts/validate_evals.py index add84d9..4517842 100644 --- a/.agents/skills/codegen-test/scripts/validate_evals.py +++ b/.agents/skills/write-tests/scripts/validate_evals.py @@ -1,5 +1,5 @@ #!/usr/bin/env python3 -"""Validate codegen-test eval files.""" +"""Validate write-tests eval files.""" from __future__ import annotations @@ -39,8 +39,8 @@ def validate(path: Path) -> list[str]: if not isinstance(data, dict): return ["evals.json must contain a JSON object"] - if data.get("skill_name") != "codegen-test": - errors.append("skill_name must be codegen-test") + if data.get("skill_name") != "write-tests": + errors.append("skill_name must be write-tests") evals = data.get("evals") if not isinstance(evals, list) or not evals: diff --git a/.agents/skills/writer-user-story/SKILL.md b/.agents/skills/write-user-story/SKILL.md similarity index 99% rename from .agents/skills/writer-user-story/SKILL.md rename to .agents/skills/write-user-story/SKILL.md index ee3cf9e..cb1023d 100644 --- a/.agents/skills/writer-user-story/SKILL.md +++ b/.agents/skills/write-user-story/SKILL.md @@ -1,5 +1,5 @@ --- -name: writer-user-story +name: write-user-story description: > Write user stories with acceptance criteria and developer tasks. Use for story writing, Jira/Linear/GitHub tickets, task breakdowns, story points, and story-level sprint planning. @@ -14,7 +14,7 @@ metadata: catalog: software-team-roles --- -# writer-user-story +# write-user-story Produce one or more **user stories** with acceptance criteria, then decompose each into **developer tasks** with file/module hints and effort estimates. diff --git a/.agents/skills/writer-user-story/evals/evals.json b/.agents/skills/write-user-story/evals/evals.json similarity index 99% rename from .agents/skills/writer-user-story/evals/evals.json rename to .agents/skills/write-user-story/evals/evals.json index 42758fc..ba8231d 100644 --- a/.agents/skills/writer-user-story/evals/evals.json +++ b/.agents/skills/write-user-story/evals/evals.json @@ -1,5 +1,5 @@ { - "skill_name": "writer-user-story", + "skill_name": "write-user-story", "evals": [ { "id": 1, diff --git a/.agents/skills/writer-user-story/references/ai-output-format.md b/.agents/skills/write-user-story/references/ai-output-format.md similarity index 100% rename from .agents/skills/writer-user-story/references/ai-output-format.md rename to .agents/skills/write-user-story/references/ai-output-format.md diff --git a/.agents/skills/writer-user-story/references/examples.md b/.agents/skills/write-user-story/references/examples.md similarity index 100% rename from .agents/skills/writer-user-story/references/examples.md rename to .agents/skills/write-user-story/references/examples.md diff --git a/.agents/skills/writer-user-story/references/output-format.md b/.agents/skills/write-user-story/references/output-format.md similarity index 100% rename from .agents/skills/writer-user-story/references/output-format.md rename to .agents/skills/write-user-story/references/output-format.md diff --git a/docs/2026-05-02-agent-playbook/SPEC.md b/docs/2026-05-02-agent-playbook/SPEC.md index 81653ca..d8e5e1d 100644 --- a/docs/2026-05-02-agent-playbook/SPEC.md +++ b/docs/2026-05-02-agent-playbook/SPEC.md @@ -60,8 +60,8 @@ Currently, LLM agents lack a standardized way to maintain context, rules, and me │ ├── testing.md │ └── security.md ├── skills/ -│ ├── on-new-file/SKILL.md -│ └── on-test-fail/SKILL.md +│ ├── create-source-file/SKILL.md +│ └── diagnose-test-failure/SKILL.md ├── commands/ │ ├── review.md │ └── scaffold.md diff --git a/docs/2026-05-02-team-roles-as-skills/PRD.md b/docs/2026-05-02-team-roles-as-skills/PRD.md index 58c17c9..400ce0d 100644 --- a/docs/2026-05-02-team-roles-as-skills/PRD.md +++ b/docs/2026-05-02-team-roles-as-skills/PRD.md @@ -33,9 +33,9 @@ The initiative targets teams and individual practitioners who want role-aware AI | Goal ID | Target Outcome | Success Metric | | --- | --- | --- | -| G-1 | Cover the core artifact-producing responsibilities of a software delivery team. | 55 cataloged skills exist across the approved prefix groups. | +| G-1 | Cover the core artifact-producing responsibilities of a software delivery team. | 55 cataloged skills exist across the approved verb groups. | | G-1a | Track current implementation progress against the catalog. | 10 of 55 catalog skills currently exist in `.agents/skills/`; current catalog completion is 18%. | -| G-2 | Make skill discovery predictable from the filesystem. | 100% of catalog skills follow the `-[-]` naming convention. | +| G-2 | Make skill discovery predictable from the filesystem. | 100% of catalog skills follow the `-[-]` naming convention. | | G-3 | Reduce repeated role-specific prompting. | Users can invoke each completed skill by artifact or task intent without restating its output structure or role conventions. | | G-4 | Produce concrete, reusable artifacts instead of generic advice. | Every completed skill description names the artifact it produces and when it should trigger. | | G-5 | Keep complex domains usable without exploding the skill count. | Multi-variant router skills select the correct reference from context or ask only when materially ambiguous. | @@ -58,7 +58,7 @@ The initiative targets teams and individual practitioners who want role-aware AI ### ✅ In Scope - A local library of 55 software-team skills defined in [SPEC.md](SPEC.md). -- Prefix-first naming across `audit`, `checklist`, `codegen`, `design`, `diagram`, `model`, `patterns`, `planner`, `report`, `review`, `setup`, `strategy`, `template`, `tracker`, and `writer`. +- Verb-first naming across `audit`, `check`, `build`, `design`, `diagram`, `model`, `document`, `plan`, `report`, `review`, `configure`, `create`, `track`, and `write`. - Skill folders containing `SKILL.md`, eval coverage, and optional `references/` for detailed variant guidance. - Multi-variant router skills for domains where one trigger should select among related artifact variants, including backend, frontend, database, testing, architecture, security, infrastructure, and templates. - Packaging each completed skill as a distributable `.skill` artifact [assumed]. @@ -86,12 +86,12 @@ The initiative targets teams and individual practitioners who want role-aware AI | Requirement ID | Capability / Feature | Priority | Acceptance Criteria | Tracker | | --- | --- | --- | --- | --- | | FR-1 | Define and track the full team-role skill catalog. | MUST | Catalog includes 55 named skills; each skill maps to at least one primary role and one output artifact; implementation status is checked against `.agents/skills/`; catalog stays aligned across PRD, SPEC, and TASKS. | [TASKS.md](TASKS.md) | -| FR-2 | Enforce prefix-first skill naming. | MUST | Every skill name follows `-[-]`; prefixes match the approved type list in SPEC.md; renames are reflected in docs and task tracking. | [SPEC.md](SPEC.md) | +| FR-2 | Enforce verb-first skill naming. | MUST | Every skill name follows `-[-]`; verbs match the approved verb list in SPEC.md; renames are reflected in docs and task tracking. | [SPEC.md](SPEC.md) | | FR-3 | Provide a standard skill structure. | MUST | Each skill has a `SKILL.md` with valid frontmatter; each skill has eval coverage; large reusable guidance lives in `references/` instead of bloating `SKILL.md`. | [SPEC.md](SPEC.md) | | FR-4 | Support multi-variant routing where domains share one role context. | SHOULD | Router skills detect variants from prompt and repo context; router skills ask at most one clarifying question when context is materially ambiguous; variant references are loaded on demand. | [SPEC.md](SPEC.md) | | FR-5 | Prioritize build order by daily leverage and role coverage. | MUST | P1 foundation skills are built first; P2/P3/P4 priorities are visible in TASKS.md; completed skills are marked in the tracker. | [TASKS.md](TASKS.md) | | FR-6 | Package completed skills for distribution. | SHOULD | Completed skills can be exported as `.skill` files; package contents include instructions, references, scripts, and assets needed for reuse; root-level evals are retained in the source folder and excluded from packaged artifacts by the current packager. | [SPEC.md](SPEC.md), [.agents/skills/README.md](../../.agents/skills/README.md) | -| FR-7 | Keep security and test responsibilities separated. | MUST | `audit-security` owns prompt-injection, jailbreak, exfiltration, secrets, and threat-modeling guidance; `codegen-test` owns functional tests, AI evals, tool-use evals, performance tests, and CI test setup. | [SPEC.md](SPEC.md) | +| FR-7 | Keep security and test responsibilities separated. | MUST | `audit-security` owns prompt-injection, jailbreak, exfiltration, secrets, and threat-modeling guidance; `write-tests` owns functional tests, AI evals, tool-use evals, performance tests, and CI test setup. | [SPEC.md](SPEC.md) | --- @@ -122,14 +122,14 @@ The initiative targets teams and individual practitioners who want role-aware AI Users invoke skills by naming the skill directly, asking for the artifact the skill owns, or describing a role-specific task. The agent should select the matching skill from its description, load only the needed references, and produce or edit the requested artifact in the repository. -For multi-variant skills, the expected interaction is context-first routing. For example, a request for API tests, E2E tests, AI evals, or performance tests should route through `codegen-test` and select the relevant testing reference without requiring the user to know the internal variant name. +For multi-variant skills, the expected interaction is context-first routing. For example, a request for API tests, E2E tests, AI evals, or performance tests should route through `write-tests` and select the relevant testing reference without requiring the user to know the internal variant name. --- ## 🗺️ User Journeys / Key Flows -1. A product owner asks for a PRD. The agent loads `writer-prd`, reads the required output format, extracts known context, marks inferences with `[assumed]`, and writes `PRD.md`. -2. A backend engineer asks for API code. The agent loads `codegen-backend`, detects language and framework from repository context, writes focused code changes, and verifies them with local tests where available. +1. A product owner asks for a PRD. The agent loads `write-prd`, reads the required output format, extracts known context, marks inferences with `[assumed]`, and writes `PRD.md`. +2. A backend engineer asks for API code. The agent loads `build-backend`, detects language and framework from repository context, writes focused code changes, and verifies them with local tests where available. 3. A maintainer adds a new skill. The maintainer follows the skill structure in SPEC.md, adds references only when needed, writes eval cases, updates TASKS.md, and packages the skill when complete. --- @@ -143,7 +143,7 @@ For multi-variant skills, the expected interaction is context-first routing. For | R-3 | Eval requirements slow down early skill creation. | MEDIUM | Build P1 skills first and treat evals as part of the definition of done, not cleanup. | OPEN | | R-4 | Team-specific conventions may not fit the base library. | MEDIUM | Keep base skills generic, then support local install-time or repository-level guidance. | OPEN | | R-5 | Documentation can drift from the actual skill folders. | HIGH | Update PRD, SPEC, TASKS, and memory notes in the same change when catalog decisions change. | OPEN | -| R-6 | Some implemented skills predate the current `creator-skill` validation rules. | HIGH | Run `quick_validate.py` per skill, then fix missing bold scan anchors, routed eval `reference` fields, and reference-section principles before release readiness. | OPEN | +| R-6 | Some implemented skills predate the current `create-skill` validation rules. | HIGH | Run `quick_validate.py` per skill, then fix missing bold scan anchors, routed eval `reference` fields, and reference-section principles before release readiness. | OPEN | --- @@ -162,8 +162,8 @@ For multi-variant skills, the expected interaction is context-first routing. For | Decision ID | Decision | Rationale | Owner | Decision Date | | --- | --- | --- | --- | --- | | DEC-1 | Use milestone gates instead of a fixed calendar date for the first complete catalog release. | The release is ready when all 55 cataloged skills are implemented, evaluated, documented, and packageable; 10 catalog skills are implemented as of 2026-05-23. | Oleg Shulyakov [assumed] | 2026-05-23 | -| DEC-2 | Use the `creator-skill` eval bar: 8-10 realistic eval prompts for focused skills and 8-10 prompts per routed reference for router skills. | This keeps the PRD aligned with the maintained authoring workflow while allowing specialized skills to add cases for variant coverage, boundary-trigger testing, or safety-sensitive behavior. | Skill maintainers [assumed] | 2026-05-23 | -| DEC-3 | Package release-ready skills from `.agents/skills/creator-skill` with `python3 -m scripts.package_skill ../ /tmp/skills-dist`. | Release readiness requires `quick_validate.py` to pass, evals to be present in source and pass at least an 85% aggregate expectation pass rate with no failed critical expectations, router evals to include `reference` fields, references to be useful, and no security or packaging blockers to remain. | Skill maintainers [assumed] | 2026-05-23 | +| DEC-2 | Use the `create-skill` eval bar: 8-10 realistic eval prompts for focused skills and 8-10 prompts per routed reference for router skills. | This keeps the PRD aligned with the maintained authoring workflow while allowing specialized skills to add cases for variant coverage, boundary-trigger testing, or safety-sensitive behavior. | Skill maintainers [assumed] | 2026-05-23 | +| DEC-3 | Package release-ready skills from `.agents/skills/create-skill` with `python3 -m scripts.package_skill ../ /tmp/skills-dist`. | Release readiness requires `quick_validate.py` to pass, evals to be present in source and pass at least an 85% aggregate expectation pass rate with no failed critical expectations, router evals to include `reference` fields, references to be useful, and no security or packaging blockers to remain. | Skill maintainers [assumed] | 2026-05-23 | | DEC-4 | Treat organization-level convention packs as a separate follow-up. | This initiative ships the base local skill library first; organization convention packs should layer on later once the base format and release checks are stable. | Oleg Shulyakov [assumed] | 2026-05-23 | --- diff --git a/docs/2026-05-02-team-roles-as-skills/SPEC.md b/docs/2026-05-02-team-roles-as-skills/SPEC.md index 76d485e..89ae688 100644 --- a/docs/2026-05-02-team-roles-as-skills/SPEC.md +++ b/docs/2026-05-02-team-roles-as-skills/SPEC.md @@ -48,7 +48,7 @@ The library must remain local-first. It is not a plugin marketplace, a project m | Goal | Success Metric | Target | | --- | --- | --- | | Complete catalog coverage | Cataloged software delivery role skills exist in `.agents/skills/`. | 55 skills | -| Keep discovery predictable | Skill names follow prefix-first convention. | 100% compliance | +| Keep discovery predictable | Skill names follow verb-first convention. | 100% compliance | | Reduce repeated prompting | Completed skills encode trigger, output, and quality expectations. | Every completed skill has specific frontmatter and instructions | | Keep complex domains usable | Router skills select variants from context. | Ask at most one clarifying question when materially ambiguous | | Maintain quality | Skills pass validation and eval thresholds. | `quick_validate.py` pass plus required eval coverage | @@ -106,20 +106,20 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G **Acceptance criteria:** - The catalog lists each skill name, primary roles, and output artifact. -- Each catalog skill maps to one approved prefix type. +- Each catalog skill maps to one approved verb. - PRD, SPEC, and TASKS agree on catalog names. - Drift between docs and `.agents/skills/` is treated as a release blocker. -#### FR-002: Prefix-First Naming +#### FR-002: Verb-First Naming **Priority:** Must-have **Actor:** Skill maintainer -**Requirement:** Every catalog skill shall use `-[-]`. +**Requirement:** Every catalog skill shall use `-[-]`. **Acceptance criteria:** -- Valid types are `audit`, `checklist`, `codegen`, `design`, `diagram`, `model`, `patterns`, `planner`, `report`, `review`, `setup`, `strategy`, `template`, `tracker`, and `writer`. -- Skill folders sort predictably by artifact type in the filesystem. +- Valid verbs are `audit`, `check`, `build`, `design`, `diagram`, `model`, `document`, `plan`, `report`, `review`, `configure`, `create`, `track`, and `write`. +- Skill folders sort predictably by action in the filesystem. - Renames update PRD, SPEC, TASKS, references, and evals in the same change. #### FR-003: Standard Skill Structure @@ -169,7 +169,7 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G **Acceptance criteria:** -- `python3 .agents/skills/creator-skill/scripts/quick_validate.py .agents/skills/` passes. +- `python3 .agents/skills/create-skill/scripts/quick_validate.py .agents/skills/` passes. - Focused skills have 8-10 realistic eval prompts. - Router skills have 8-10 eval prompts per routed reference before release readiness. - Eval assertions reach at least 85% aggregate pass rate with no failed critical expectations. @@ -183,7 +183,7 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G **Acceptance criteria:** -- Packaging runs from `.agents/skills/creator-skill`. +- Packaging runs from `.agents/skills/create-skill`. - Package command succeeds: `python3 -m scripts.package_skill ../ /tmp/skills-dist`. - Package includes required instructions, references, scripts, and assets. - Root-level `evals/` are intentionally excluded from packaged artifacts by `package_skill.py`. @@ -198,7 +198,7 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G **Acceptance criteria:** - `audit-security` owns prompt injection, jailbreak, exfiltration, secrets, OWASP review, and threat modeling. -- `codegen-test` owns executable tests, AI evals, tool-use evals, performance tests, fixtures, framework setup, and CI test setup. +- `write-tests` owns executable tests, AI evals, tool-use evals, performance tests, fixtures, framework setup, and CI test setup. - Boundary prompts route consistently between the two. ## 3. Non-Functional Requirements @@ -217,13 +217,13 @@ Runtime plugin hosting, remote skill fetching, marketplace behavior, live Jira/G ### 4.1 Naming Convention -All skills use prefix-first naming: +All skills use verb-first naming: ```text --[-] +-[-] ``` -The type identifies the artifact or action family. The subject identifies the domain. The optional variant is allowed only when a separate folder is clearer than a router reference. +The verb identifies the artifact or action family. The subject identifies the domain. The optional variant is allowed only when a separate folder is clearer than a router reference. ### 4.2 Filesystem Layout @@ -284,7 +284,7 @@ Router skills use one `SKILL.md` plus variant references when related artifacts 4. Ask one concise question only when the route changes the output materially. 5. Mark inferred details with `[assumed]` when producing a spec or planning artifact. -Router skills for this release are `audit-security`, `codegen-frontend`, `codegen-backend`, `codegen-database`, `codegen-mobile`, `codegen-test`, `design-arch`, `writer-spec`, `setup-infra`, `template-creator`, `writer-tech-docs`, `review-code`, and `planner-capacity`. +Router skills for this release are `audit-security`, `build-frontend`, `build-backend`, `build-database`, `build-mobile`, `write-tests`, `design-arch`, `write-spec`, `configure-infra`, `create-template`, `write-tech-docs`, `review-code`, and `plan-capacity`. ## 5. Catalog @@ -296,57 +296,57 @@ Router skills for this release are `audit-security`, `codegen-frontend`, `codege | `audit-gap` | System Analyst | Gap analysis report: current state, target state, remediation | | `audit-security` | Security Eng | Security router: OWASP review, secrets audit, threat model | | `audit-test-flaky` | AQA | Flaky test report with root cause and fix recommendations | -| `checklist-release` | Release Manager | Release checklist with rollback criteria | -| `codegen-backend` | Backend Dev | Backend code: routes, services, middleware, tests | -| `codegen-database` | DBA, Backend, Data Eng | Database code: schemas, SQL, migrations, analytics queries | -| `codegen-frontend` | Frontend Dev | Frontend code: components, pages, state, styling | -| `codegen-mobile` | Mobile Dev | Mobile code: screens, navigation, platform patterns | -| `codegen-test` | AQA | Test suites, eval harnesses, fixtures, configs, CI setup | +| `check-release` | Release Manager | Release checklist with rollback criteria | +| `build-backend` | Backend Dev | Backend code: routes, services, middleware, tests | +| `build-database` | DBA, Backend, Data Eng | Database code: schemas, SQL, migrations, analytics queries | +| `build-frontend` | Frontend Dev | Frontend code: components, pages, state, styling | +| `build-mobile` | Mobile Dev | Mobile code: screens, navigation, platform patterns | +| `write-tests` | AQA | Test suites, eval harnesses, fixtures, configs, CI setup | | `design-api` | Backend Dev | API contract: OpenAPI, AsyncAPI, GraphQL, endpoints, schemas | | `design-arch` | Architect | Architecture router: system design, ADR, C4 diagram | | `diagram-dfd` | System Analyst | Data flow diagram in Mermaid or structured text | | `diagram-integration` | System Analyst | Integration map: systems, APIs, data flows, ownership | | `diagram-ux-flow` | UX Designer | User flow or journey map | | `model-dbt` | Data Eng | dbt model with SQL, schema, tests, and docs | -| `patterns-auth` | Backend Dev | Auth implementation patterns for JWT, OAuth2, sessions, RBAC | -| `patterns-graphql` | Backend Dev | GraphQL schema, resolver, pagination, and N+1 patterns | -| `patterns-realtime` | Backend Dev | WebSocket, SSE, and polling strategy patterns | -| `planner-capacity` | DevOps, SRE | Capacity plan for traffic, storage, compute, and scaling | -| `planner-sprint` | Scrum Master | Sprint plan with goal, capacity, stories, impediments | +| `document-auth-patterns` | Backend Dev | Auth implementation patterns for JWT, OAuth2, sessions, RBAC | +| `document-graphql-patterns` | Backend Dev | GraphQL schema, resolver, pagination, and N+1 patterns | +| `document-realtime-patterns` | Backend Dev | WebSocket, SSE, and polling strategy patterns | +| `plan-capacity` | DevOps, SRE | Capacity plan for traffic, storage, compute, and scaling | +| `plan-sprint` | Scrum Master | Sprint plan with goal, capacity, stories, impediments | | `report-cve` | Security Eng | CVE triage report with affected versions and remediation | | `report-db-health` | DBA | Database health report | | `report-team-health` | Team Lead | Team health report with delivery and risk signals | | `review-code` | Team Lead | Code review findings prioritized by risk | -| `setup-developer-portal` | Platform Eng | Developer portal setup and onboarding structure | -| `setup-eval-harness` | ML Eng | Eval harness with dataset, rubric, metrics, benchmark runner | -| `setup-infra` | DevOps, Data Eng | Infrastructure setup router: IaC, CI/CD, ETL, observability | -| `setup-monorepo` | Platform Eng | Monorepo setup and tooling configuration | -| `setup-rag` | AI Eng | RAG pipeline setup | -| `strategy-api-versioning` | Backend Dev, Architect | API versioning and deprecation strategy | -| `strategy-backup` | DBA | Backup strategy with retention and restore SLAs | -| `strategy-dependency-upgrade` | Release Manager, DevOps | Dependency upgrade strategy | -| `strategy-feature-flag` | Team Lead, Backend | Feature flag rollout, lifecycle, and kill-switch strategy | -| `template-creator` | Team Lead, Scrum Master, PM, PO | Reusable templates for team workflows | -| `tracker-velocity` | Scrum Master | Sprint metrics and velocity report | -| `writer-alert-rules` | SRE | Alert rules with severity, routing, and runbook links | -| `writer-backlog` | PO | Groomed backlog with priority, sizing, and dependencies | -| `writer-compliance` | Security, Legal | Compliance documentation and evidence checklist | -| `writer-epic` | PO | Epic with goal, value, child stories, definition of done | -| `writer-lineage` | Data Eng | Data lineage document | -| `writer-mentorship` | Team Lead | Mentorship guide | -| `writer-ml-experiment` | ML Eng | ML experiment report and model-card section | -| `writer-postmortem` | Team Lead, SRE | Postmortem with timeline, root cause, action items | -| `writer-prd` | PM, PO | Product Requirements Document | -| `writer-prompt` | ML, AI Eng | Prompt specification with examples and eval criteria | -| `writer-slo` | SRE | SLO definition with SLI, target, error budget, alerts | -| `writer-spec` | SA, Architect, UX | Functional, technical, NFR, design, or data-contract spec | -| `writer-stakeholder` | PM, PO | Stakeholder update | -| `writer-team-agreement` | Scrum Master | Team working agreement | -| `writer-tech-docs` | Tech Writer, Backend, SRE, Release Mgr | Technical docs router: README, API docs, runbooks, changelog, release notes | -| `writer-tech-radar` | Architect | Tech radar | -| `writer-test-strategy` | AQA, QA | Test strategy | -| `writer-use-case` | System Analyst | Use case document | -| `writer-user-story` | PO, Team Lead | User story with acceptance criteria and developer tasks | +| `configure-developer-portal` | Platform Eng | Developer portal setup and onboarding structure | +| `configure-eval-harness` | ML Eng | Eval harness with dataset, rubric, metrics, benchmark runner | +| `configure-infra` | DevOps, Data Eng | Infrastructure setup router: IaC, CI/CD, ETL, observability | +| `configure-monorepo` | Platform Eng | Monorepo setup and tooling configuration | +| `configure-rag` | AI Eng | RAG pipeline setup | +| `plan-api-versioning` | Backend Dev, Architect | API versioning and deprecation strategy | +| `plan-backup` | DBA | Backup strategy with retention and restore SLAs | +| `plan-dependency-upgrade` | Release Manager, DevOps | Dependency upgrade strategy | +| `plan-feature-flag` | Team Lead, Backend | Feature flag rollout, lifecycle, and kill-switch strategy | +| `create-template` | Team Lead, Scrum Master, PM, PO | Reusable templates for team workflows | +| `track-velocity` | Scrum Master | Sprint metrics and velocity report | +| `write-alert-rules` | SRE | Alert rules with severity, routing, and runbook links | +| `write-backlog` | PO | Groomed backlog with priority, sizing, and dependencies | +| `write-compliance` | Security, Legal | Compliance documentation and evidence checklist | +| `write-epic` | PO | Epic with goal, value, child stories, definition of done | +| `write-lineage` | Data Eng | Data lineage document | +| `write-mentorship` | Team Lead | Mentorship guide | +| `write-ml-experiment` | ML Eng | ML experiment report and model-card section | +| `write-postmortem` | Team Lead, SRE | Postmortem with timeline, root cause, action items | +| `write-prd` | PM, PO | Product Requirements Document | +| `write-prompt` | ML, AI Eng | Prompt specification with examples and eval criteria | +| `write-slo` | SRE | SLO definition with SLI, target, error budget, alerts | +| `write-spec` | SA, Architect, UX | Functional, technical, NFR, design, or data-contract spec | +| `write-stakeholder` | PM, PO | Stakeholder update | +| `write-team-agreement` | Scrum Master | Team working agreement | +| `write-tech-docs` | Tech Writer, Backend, SRE, Release Mgr | Technical docs router: README, API docs, runbooks, changelog, release notes | +| `write-tech-radar` | Architect | Tech radar | +| `write-test-strategy` | AQA, QA | Test strategy | +| `write-use-case` | System Analyst | Use case document | +| `write-user-story` | PO, Team Lead | User story with acceptance criteria and developer tasks | ## 6. Variant References @@ -354,32 +354,32 @@ Router skills for this release are `audit-security`, `codegen-frontend`, `codege | Skill | Required references | | --- | --- | -| `writer-spec` | `functional.md`, `technical.md`, `non-functional.md`, `design-ui.md`, `data-contract.md` | +| `write-spec` | `functional.md`, `technical.md`, `non-functional.md`, `design-ui.md`, `data-contract.md` | | `design-arch` | `system-design.md`, `adr.md`, `c4.md` | -| `codegen-database` | `schema-design.md`, `migration.md`, `common.md`, plus supported dialect references | -| `codegen-frontend` | Language, framework, styling, accessibility, forms, state, performance, PWA, i18n, visualization references | -| `codegen-backend` | Language-level references plus supported framework references | -| `codegen-mobile` | `swift.md`, `kotlin-android.md`, `react-native.md`, `flutter.md` | -| `codegen-test` | `e2e.md`, `api.md`, `perf.md`, `framework-setup.md`, `ai-output.md`, `ai-tool-use.md`, `ai-perf.md` | -| `setup-infra` | `iac.md`, `cicd.md`, `etl.md`, `observability.md` | -| `planner-capacity` | `db.md`, `infra.md` | +| `build-database` | `schema-design.md`, `migration.md`, `common.md`, plus supported dialect references | +| `build-frontend` | Language, framework, styling, accessibility, forms, state, performance, PWA, i18n, visualization references | +| `build-backend` | Language-level references plus supported framework references | +| `build-mobile` | `swift.md`, `kotlin-android.md`, `react-native.md`, `flutter.md` | +| `write-tests` | `e2e.md`, `api.md`, `perf.md`, `framework-setup.md`, `ai-output.md`, `ai-tool-use.md`, `ai-perf.md` | +| `configure-infra` | `iac.md`, `cicd.md`, `etl.md`, `observability.md` | +| `plan-capacity` | `db.md`, `infra.md` | | `audit-security` | `owasp.md`, `secrets.md`, `threat-model.md` | -| `writer-tech-docs` | `readme.md`, `api-docs.md`, `runbook-routine.md`, `runbook-oncall.md`, `changelog.md`, `release-notes.md` | +| `write-tech-docs` | `readme.md`, `api-docs.md`, `runbook-routine.md`, `runbook-oncall.md`, `changelog.md`, `release-notes.md` | | `review-code` | `checklist.md`, `regressions.md`, `security.md`, `performance.md`, `test-gaps.md` | -| `template-creator` | `pr.md`, `retro.md`, `issue.md`, `meeting.md`, `decision.md`, `incident.md`, `release.md` | +| `create-template` | `pr.md`, `retro.md`, `issue.md`, `meeting.md`, `decision.md`, `incident.md`, `release.md` | ### 6.2 Collision Rules | Pair | Routing rule | | --- | --- | -| `writer-prd` vs `writer-spec` | PRD owns product goals, personas, scope, and success metrics; spec owns behavior, technical detail, system handoff, and requirements. | -| `design-api` vs `writer-tech-docs` API docs | `design-api` is contract-first before implementation; `writer-tech-docs` documents an existing API. | +| `write-prd` vs `write-spec` | PRD owns product goals, personas, scope, and success metrics; spec owns behavior, technical detail, system handoff, and requirements. | +| `design-api` vs `write-tech-docs` API docs | `design-api` is contract-first before implementation; `write-tech-docs` documents an existing API. | | `design-arch` variants | System design is broad architecture; ADR is one decision; C4 is diagram-focused. | -| `writer-user-story` vs `writer-epic` | User story is one deliverable with acceptance criteria and tasks; epic groups related stories. | -| `codegen-test` vs `writer-test-strategy` | `codegen-test` writes executable tests/config/evals; `writer-test-strategy` writes planning guidance. | +| `write-user-story` vs `write-epic` | User story is one deliverable with acceptance criteria and tasks; epic groups related stories. | +| `write-tests` vs `write-test-strategy` | `write-tests` writes executable tests/config/evals; `write-test-strategy` writes planning guidance. | | `review-code` vs `audit-security` | `review-code` reviews a code change; `audit-security` performs standalone security analysis. | -| `template-creator` vs `writer-*` | `template-creator` creates reusable blank templates; `writer-*` creates filled artifacts. | -| `audit-security` vs `codegen-test` AI evals | `audit-security` owns abuse, exfiltration, secrets, and threat modeling; `codegen-test` owns quality, tool-use, latency, cost, and regression evals. | +| `create-template` vs `write-*` | `create-template` creates reusable blank templates; `write-*` creates filled artifacts. | +| `audit-security` vs `write-tests` AI evals | `audit-security` owns abuse, exfiltration, secrets, and threat modeling; `write-tests` owns quality, tool-use, latency, cost, and regression evals. | ## 7. Validation @@ -388,7 +388,7 @@ Router skills for this release are `audit-security`, `codegen-frontend`, `codege Each release-ready skill must pass: ```bash -python3 .agents/skills/creator-skill/scripts/quick_validate.py .agents/skills/ +python3 .agents/skills/create-skill/scripts/quick_validate.py .agents/skills/ ``` Validation failures block packaging. Common blockers include invalid frontmatter, missing required sections, weak scan anchors, malformed evals, missing router `reference` fields, and unused placeholder folders. @@ -424,7 +424,7 @@ Reviewers should inspect: ## 9. Build Process -Each skill should be built with `creator-skill` using this sequence: +Each skill should be built with `create-skill` using this sequence: 1. Clarify trigger scope, expected output, routing needs, and eval expectations. 2. Draft `SKILL.md` with frontmatter, concise workflow instructions, clear section headings, and scan anchors. @@ -435,7 +435,7 @@ Each skill should be built with `creator-skill` using this sequence: 7. Review outputs qualitatively and assertions quantitatively where objective checks apply. 8. Iterate until feedback is resolved, improvements flatten, or the user accepts behavior. 9. Tune the description for triggering accuracy after behavior is stable. -10. Package release-ready skills from `.agents/skills/creator-skill`: +10. Package release-ready skills from `.agents/skills/create-skill`: ```bash python3 -m scripts.package_skill ../ /tmp/skills-dist @@ -483,7 +483,7 @@ python3 -m scripts.package_skill ../ /tmp/skills-dist | --- | --- | --- | --- | | Use milestone gates instead of a fixed date. | Release depends on complete implementation, evals, docs, and packaging. | Oleg Shulyakov | 2026-05-23 | | Use router skills for complex shared domains. | Prevents skill-count explosion while keeping role context coherent. | Skill maintainers | 2026-05-23 | -| Use `creator-skill` validation and eval expectations. | Keeps skill authoring aligned with the maintained local workflow. | Skill maintainers | 2026-05-23 | +| Use `create-skill` validation and eval expectations. | Keeps skill authoring aligned with the maintained local workflow. | Skill maintainers | 2026-05-23 | | Defer organization convention packs. | Base local skill library should stabilize before layering org-specific behavior. | Oleg Shulyakov | 2026-05-23 | ## 13. Resolved Questions @@ -500,12 +500,12 @@ python3 -m scripts.package_skill ../ /tmp/skills-dist - Product requirements: [PRD.md](PRD.md) - Build tracker: [TASKS.md](TASKS.md) - Prior memory note: [.agents/memory/2026-05-18.md](../../.agents/memory/2026-05-18.md) -- Skill authoring support: [creator-skill](../../.agents/skills/creator-skill/SKILL.md) +- Skill authoring support: [create-skill](../../.agents/skills/create-skill/SKILL.md) ### 14.2 Totals | Item | Count | | --- | ---: | | Catalog skills | 55 | -| Approved prefix types | 15 | +| Approved verbs | 15 | | Required router skills | 13 | diff --git a/docs/2026-05-02-team-roles-as-skills/TASKS.md b/docs/2026-05-02-team-roles-as-skills/TASKS.md index ee98a66..db20859 100644 --- a/docs/2026-05-02-team-roles-as-skills/TASKS.md +++ b/docs/2026-05-02-team-roles-as-skills/TASKS.md @@ -8,30 +8,30 @@ Each skill is a `SKILL.md` that teaches the agent how to produce a specific arti ## Naming Convention ```text --[-] +-[-] ``` -The **type prefix** comes first so skills sort naturally on the filesystem and visually cluster by what they _do_, not what they’re about. +The **verb prefix** comes first so skills sort naturally on the filesystem and visually cluster by what they _do_, not what they’re about. Use `[-]` only when the variant needs its own trigger, eval set, and lifecycle. Otherwise, keep variants as router references under one skill. -| Prefix | Produces | +| Verb | Produces | | ------------ | ------------------------------------------------ | | `audit-` | Review report or model with findings, risks, and recommendations | -| `checklist-` | Step-by-step verification list | -| `codegen-` | Source code, scripts, or executable configuration files | +| `check-` | Step-by-step verification list | +| `build-` | Source code, scripts, or executable configuration files | | `design-` | Design document or spec (contract-first) | | `diagram-` | Visual diagram (C4, DFD, flow, etc.) | | `model-` | Structured model definition | -| `patterns-` | Pattern catalogue with examples | -| `planner-` | Planning document with estimates | +| `document-` | Pattern catalogue with examples | +| `plan-` | Planning document with estimates | | `report-` | Status or analysis report | | `review-` | Review findings against a concrete code or artifact change | -| `setup-` | Configuration files and scaffolding | -| `strategy-` | Decision framework and approach | -| `template-` | Reusable blank template | -| `tracker-` | Metrics or progress tracking document | -| `writer-` | Authored prose artifact (spec, doc, story, etc.) | +| `configure-` | Configuration files and scaffolding | +| `plan-` | Decision framework and approach | +| `create-` | Reusable blank template | +| `track-` | Metrics or progress tracking document | +| `write-` | Authored prose artifact (spec, doc, story, etc.) | --- @@ -60,21 +60,21 @@ Ordered alphabetically by name (matches filesystem order). | - [x] | `audit-skill-security` | 🟠 P2 | Security | Security Engineer | Pre-install skill security audit with findings, risks, and install recommendation | | - [ ] | `audit-test-flaky` | 🟡 P3 | Testing | AQA | Root cause report for flaky tests with fix recommendations | -### `checklist-` +### `check-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ----------------------- | -------- | ---------- | --------------- | ------------------------------------------------- | -| - [ ] | `checklist-release` | 🟡 P3 | Release | Release Manager | Go/no-go release checklist with sign-off sections | +| - [ ] | `check-release` | 🟡 P3 | Release | Release Manager | Go/no-go release checklist with sign-off sections | -### `codegen-` +### `build-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ------------------ | -------- | ------- | ------------- | ------------------------------------------------------------------------------------------- | -| - [x] | `codegen-backend` | 🔴 P1 | Code | Backend Dev | Production-ready backend code across TIOBE-informed backend routes | -| - [x] | `codegen-database` | 🔴 P1 | Database | DBA / Backend | Database code router for OLTP SQL, analytics SQL, schema design, and migrations | -| - [x] | `codegen-frontend` | 🔴 P1 | Code | Frontend Dev | Production-ready frontend code + design system tokens + component style guide | -| - [ ] | `codegen-mobile` | 🟠 P2 | Code | Mobile Dev | Production-ready mobile code (Swift/iOS, Kotlin/Android, React Native, Flutter) | -| - [x] | `codegen-test` | 🔴 P1 | Testing | AQA / Backend / ML | Test suite and test framework generation (e2e, api, perf, AI evals, CI config) | +| - [x] | `build-backend` | 🔴 P1 | Code | Backend Dev | Production-ready backend code across TIOBE-informed backend routes | +| - [x] | `build-database` | 🔴 P1 | Database | DBA / Backend | Database code router for OLTP SQL, analytics SQL, schema design, and migrations | +| - [x] | `build-frontend` | 🔴 P1 | Code | Frontend Dev | Production-ready frontend code + design system tokens + component style guide | +| - [ ] | `build-mobile` | 🟠 P2 | Code | Mobile Dev | Production-ready mobile code (Swift/iOS, Kotlin/Android, React Native, Flutter) | +| - [x] | `write-tests` | 🔴 P1 | Testing | AQA / Backend / ML | Test suite and test framework generation (e2e, api, perf, AI evals, CI config) | ### `design-` @@ -97,20 +97,20 @@ Ordered alphabetically by name (matches filesystem order). | ----- | -------------- | -------- | -------- | ----------------- | -------------------------------------------------- | | - [ ] | `model-dbt` | 🟡 P3 | Data | Data Engineer | dbt model definitions with tests and documentation | -### `patterns-` +### `document-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ------------------- | -------- | ------ | ------------ | ------------------------------------------------------------------------------------- | -| - [ ] | `patterns-auth` | 🟠 P2 | Code | Backend Dev | Auth pattern catalogue (JWT, OAuth2, sessions, API keys) with implementation examples | -| - [ ] | `patterns-graphql` | 🟡 P3 | Code | Backend Dev | GraphQL schema, resolver, and N+1 pattern guide | -| - [ ] | `patterns-realtime` | 🟡 P3 | Code | Backend Dev | WebSocket / SSE / polling pattern guide with tradeoffs | +| - [ ] | `document-auth-patterns` | 🟠 P2 | Code | Backend Dev | Auth pattern catalogue (JWT, OAuth2, sessions, API keys) with implementation examples | +| - [ ] | `document-graphql-patterns` | 🟡 P3 | Code | Backend Dev | GraphQL schema, resolver, and N+1 pattern guide | +| - [ ] | `document-realtime-patterns` | 🟡 P3 | Code | Backend Dev | WebSocket / SSE / polling pattern guide with tradeoffs | -### `planner-` +### `plan-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ------------------ | -------- | ------ | ------------ | ---------------------------------------------------------- | -| - [ ] | `planner-capacity` | ⚪ P4 | Ops | DBA / DevOps | Capacity plan with growth projections and scaling triggers | -| - [ ] | `planner-sprint` | 🟡 P3 | Agile | Scrum Master | Sprint plan with goals, capacity, impediment log | +| - [ ] | `plan-capacity` | ⚪ P4 | Ops | DBA / DevOps | Capacity plan with growth projections and scaling triggers | +| - [ ] | `plan-sprint` | 🟡 P3 | Agile | Scrum Master | Sprint plan with goals, capacity, impediment log | ### `report-` @@ -126,57 +126,57 @@ Ordered alphabetically by name (matches filesystem order). | ----- | ------------- | -------- | ---------- | ------------ | --------------------------------------------------------------------- | | - [x] | `review-code` | 🟠 P2 | Leadership | Team Lead | Structured code review findings plus a reusable review checklist reference | -### `setup-` +### `configure-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ------------------------ | -------- | ------------ | ----------------- | ------------------------------------------------------------ | -| - [ ] | `setup-developer-portal` | ⚪ P4 | Platform | Platform Engineer | Internal developer portal structure with service catalog | -| - [ ] | `setup-eval-harness` | 🟡 P3 | ML / AI | ML Engineer | Model evaluation harness with metrics and baselines | -| - [ ] | `setup-infra` | 🟠 P2 | DevOps | DevOps | Ops setup router for IaC, observability, CI/CD, and ETL pipeline config | -| - [ ] | `setup-monorepo` | 🟡 P3 | Platform | Platform Engineer | Monorepo configuration (Nx, Turborepo, Bazel) | -| - [ ] | `setup-rag` | 🟡 P3 | ML / AI | AI Engineer | RAG pipeline setup (chunking, embedding, retrieval) | +| - [ ] | `configure-developer-portal` | ⚪ P4 | Platform | Platform Engineer | Internal developer portal structure with service catalog | +| - [ ] | `configure-eval-harness` | 🟡 P3 | ML / AI | ML Engineer | Model evaluation harness with metrics and baselines | +| - [ ] | `configure-infra` | 🟠 P2 | DevOps | DevOps | Ops setup router for IaC, observability, CI/CD, and ETL pipeline config | +| - [ ] | `configure-monorepo` | 🟡 P3 | Platform | Platform Engineer | Monorepo configuration (Nx, Turborepo, Bazel) | +| - [ ] | `configure-rag` | 🟡 P3 | ML / AI | AI Engineer | RAG pipeline setup (chunking, embedding, retrieval) | -### `strategy-` +### `plan-` strategy | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ----------------------------- | -------- | -------- | ------------------- | --------------------------------------------------------------- | -| - [ ] | `strategy-api-versioning` | 🟡 P3 | Code | Backend Dev | API versioning strategy with deprecation and migration guide | -| - [ ] | `strategy-backup` | 🟡 P3 | Database | DBA | Backup and recovery strategy with RPO/RTO targets | -| - [ ] | `strategy-dependency-upgrade` | 🟡 P3 | Release | DevOps / Team Lead | Dependency upgrade strategy with risk assessment | -| - [ ] | `strategy-feature-flag` | 🟡 P3 | Code | Team Lead / Backend | Feature flag strategy with rollout and rollback plan | +| - [ ] | `plan-api-versioning` | 🟡 P3 | Code | Backend Dev | API versioning strategy with deprecation and migration guide | +| - [ ] | `plan-backup` | 🟡 P3 | Database | DBA | Backup and recovery strategy with RPO/RTO targets | +| - [ ] | `plan-dependency-upgrade` | 🟡 P3 | Release | DevOps / Team Lead | Dependency upgrade strategy with risk assessment | +| - [ ] | `plan-feature-flag` | 🟡 P3 | Code | Team Lead / Backend | Feature flag strategy with rollout and rollback plan | -### `template-` +### `create-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ---------------- | -------- | ---------- | ------------ | --------------------------------------------------------------- | -| - [ ] | `template-creator` | 🟡 P3 | Leadership / Agile | Team Lead / Scrum Master | Reusable team templates for PRs, retros, issues, meetings, decisions, incidents, and releases | +| - [ ] | `create-template` | 🟡 P3 | Leadership / Agile | Team Lead / Scrum Master | Reusable team templates for PRs, retros, issues, meetings, decisions, incidents, and releases | -### `tracker-` +### `track-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ------------------ | -------- | ------ | ------------ | ---------------------------------------------- | -| - [ ] | `tracker-velocity` | ⚪ P4 | Agile | Scrum Master | Sprint velocity report with trend and forecast | +| - [ ] | `track-velocity` | ⚪ P4 | Agile | Scrum Master | Sprint velocity report with trend and forecast | -### `writer-` +### `write-` | Done | Skill | Priority | Domain | Primary Role | Produces | | ----- | ----------------------- | -------- | ------------ | ------------------- | --------------------------------------------------------------------- | -| - [ ] | `writer-alert-rules` | 🟡 P3 | DevOps / SRE | SRE | Alert rule definitions with severity and runbook links | -| - [ ] | `writer-backlog` | 🟡 P3 | Agile | Product Owner | Groomed backlog with priorities, estimates, and dependencies | -| - [ ] | `writer-compliance` | ⚪ P4 | Security | Security / Legal | Compliance documentation (GDPR, SOC2, HIPAA) | -| - [ ] | `writer-epic` | 🟠 P2 | Agile | Product Owner | Epic definition with goal, scope, child stories, DoD | -| - [ ] | `writer-lineage` | ⚪ P4 | Data | Data Engineer | Data lineage documentation (sources, transforms, destinations) | -| - [ ] | `writer-mentorship` | ⚪ P4 | Leadership | Team Lead | Mentorship guide with goals, checkpoints, and resources | -| - [ ] | `writer-ml-experiment` | 🟡 P3 | ML / AI | ML Engineer | ML experiment report with setup, results, and model card | -| - [ ] | `writer-postmortem` | 🟡 P3 | Leadership | Team Lead / SRE | Incident postmortem (timeline, root cause, action items) | -| - [x] | `writer-prd` | 🔴 P1 | Requirements | PM / PO | Product Requirements Document (goals, personas, scope, metrics) | -| - [ ] | `writer-prompt` | 🟡 P3 | ML / AI | ML / AI Engineer | Optimized prompt with system instructions, examples, and eval | -| - [x] | `writer-tech-docs` | 🔴 P1 | Docs | Tech Writer | Technical docs: README, API docs, runbooks, changelog, release notes | -| - [ ] | `writer-slo` | 🟡 P3 | DevOps / SRE | SRE | SLO definition with indicators, targets, and error budget | -| - [x] | `writer-spec` | 🔴 P1 | Requirements | SA / Architect / UX | Specification document (functional, tech, NFR, design, data-contract) | -| - [ ] | `writer-stakeholder` | 🟡 P3 | Agile | PM / PO | Stakeholder update (status, risks, decisions needed) | -| - [x] | `writer-user-story` | 🔴 P1 | Agile | PO / Team Lead | User stories with acceptance criteria decomposed into dev tasks | -| - [ ] | `writer-team-agreement` | ⚪ P4 | Agile | Scrum Master | Team working agreement (definition of done, norms, ceremonies) | -| - [ ] | `writer-tech-radar` | ⚪ P4 | Architecture | Solution Architect | Technology radar (adopt, trial, assess, hold) | -| - [ ] | `writer-test-strategy` | 🟠 P2 | Testing | AQA / QA | Test strategy document (scope, levels, tools, coverage targets) | -| - [ ] | `writer-use-case` | 🟡 P3 | Requirements | System Analyst | Use case document (actors, preconditions, main/alternate flows) | +| - [ ] | `write-alert-rules` | 🟡 P3 | DevOps / SRE | SRE | Alert rule definitions with severity and runbook links | +| - [ ] | `write-backlog` | 🟡 P3 | Agile | Product Owner | Groomed backlog with priorities, estimates, and dependencies | +| - [ ] | `write-compliance` | ⚪ P4 | Security | Security / Legal | Compliance documentation (GDPR, SOC2, HIPAA) | +| - [ ] | `write-epic` | 🟠 P2 | Agile | Product Owner | Epic definition with goal, scope, child stories, DoD | +| - [ ] | `write-lineage` | ⚪ P4 | Data | Data Engineer | Data lineage documentation (sources, transforms, destinations) | +| - [ ] | `write-mentorship` | ⚪ P4 | Leadership | Team Lead | Mentorship guide with goals, checkpoints, and resources | +| - [ ] | `write-ml-experiment` | 🟡 P3 | ML / AI | ML Engineer | ML experiment report with setup, results, and model card | +| - [ ] | `write-postmortem` | 🟡 P3 | Leadership | Team Lead / SRE | Incident postmortem (timeline, root cause, action items) | +| - [x] | `write-prd` | 🔴 P1 | Requirements | PM / PO | Product Requirements Document (goals, personas, scope, metrics) | +| - [ ] | `write-prompt` | 🟡 P3 | ML / AI | ML / AI Engineer | Optimized prompt with system instructions, examples, and eval | +| - [x] | `write-tech-docs` | 🔴 P1 | Docs | Tech Writer | Technical docs: README, API docs, runbooks, changelog, release notes | +| - [ ] | `write-slo` | 🟡 P3 | DevOps / SRE | SRE | SLO definition with indicators, targets, and error budget | +| - [x] | `write-spec` | 🔴 P1 | Requirements | SA / Architect / UX | Specification document (functional, tech, NFR, design, data-contract) | +| - [ ] | `write-stakeholder` | 🟡 P3 | Agile | PM / PO | Stakeholder update (status, risks, decisions needed) | +| - [x] | `write-user-story` | 🔴 P1 | Agile | PO / Team Lead | User stories with acceptance criteria decomposed into dev tasks | +| - [ ] | `write-team-agreement` | ⚪ P4 | Agile | Scrum Master | Team working agreement (definition of done, norms, ceremonies) | +| - [ ] | `write-tech-radar` | ⚪ P4 | Architecture | Solution Architect | Technology radar (adopt, trial, assess, hold) | +| - [ ] | `write-test-strategy` | 🟠 P2 | Testing | AQA / QA | Test strategy document (scope, levels, tools, coverage targets) | +| - [ ] | `write-use-case` | 🟡 P3 | Requirements | System Analyst | Use case document (actors, preconditions, main/alternate flows) | diff --git a/pages/PLAYBOOK.md b/pages/PLAYBOOK.md index 24dc25e..f07fa73 100644 --- a/pages/PLAYBOOK.md +++ b/pages/PLAYBOOK.md @@ -144,13 +144,13 @@ Skills are pre-defined workflows that the agent can load when the current task m skills//SKILL.md ``` -Examples: `skills/on-new-file/SKILL.md`, `skills/on-test-fail/SKILL.md`, `skills/on-pr-open/SKILL.md`, `skills/on-commit/SKILL.md` +Examples: `skills/create-source-file/SKILL.md`, `skills/diagnose-test-failure/SKILL.md`, `skills/review-pull-request/SKILL.md`, `skills/prepare-commit/SKILL.md` #### File Schema ```markdown --- -name: on-new-file +name: create-source-file description: Auto-generates a matching test file when a new TypeScript file is created when_to_use: Use when creating or updating TypeScript source files that may need matching tests. paths: ["src/**/*.ts"] @@ -511,9 +511,9 @@ my-saas-app/ │ │ ├── testing.md # Test coverage requirements │ │ └── security.md # OWASP top-10 awareness │ ├── skills/ -│ │ ├── on-new-file/ # Auto-scaffold test files +│ │ ├── create-source-file/ # Auto-scaffold test files │ │ │ └── SKILL.md -│ │ └── on-test-fail/ # Diagnose CI failures +│ │ └── diagnose-test-failure/ # Diagnose CI failures │ │ └── SKILL.md │ ├── commands/ │ │ ├── review.md # /review — structured code review diff --git a/pages/index.md b/pages/index.md index 2098051..0df11d8 100644 --- a/pages/index.md +++ b/pages/index.md @@ -87,9 +87,9 @@ priority: high Skills are reusable procedures the agent can load when the current task matches their metadata, or when the user invokes them directly. -- `skills/on-new-file/SKILL.md` → use when creating source files that need matching tests -- `skills/on-test-fail/SKILL.md` → use when diagnosing failing tests or CI -- `skills/on-commit/SKILL.md` → use when preparing a commit +- `skills/create-source-file/SKILL.md` → use when creating source files that need matching tests +- `skills/diagnose-test-failure/SKILL.md` → use when diagnosing failing tests or CI +- `skills/prepare-commit/SKILL.md` → use when preparing a commit Use `description` and `when_to_use` to explain when a skill applies. Use `paths` to scope a skill to matching files, and `disable-model-invocation: true` for workflows that should only run when explicitly invoked.