@event4u/agent-config 2.26.0 → 3.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent-src/commands/agent-handoff.md +15 -3
- package/.agent-src/commands/agent-status.md +12 -0
- package/.agent-src/commands/agents/audit.md +12 -0
- package/.agent-src/commands/agents/init.md +12 -0
- package/.agent-src/commands/agents/optimize.md +12 -0
- package/.agent-src/commands/agents/user/accept.md +12 -0
- package/.agent-src/commands/agents/user/init.md +12 -0
- package/.agent-src/commands/agents/user/review.md +12 -0
- package/.agent-src/commands/agents/user/show.md +12 -0
- package/.agent-src/commands/agents/user/update.md +12 -0
- package/.agent-src/commands/agents/user.md +12 -0
- package/.agent-src/commands/agents.md +12 -0
- package/.agent-src/commands/analyze-reference-repo.md +15 -3
- package/.agent-src/commands/bug-fix.md +12 -0
- package/.agent-src/commands/bug-investigate.md +13 -1
- package/.agent-src/commands/challenge-me/vision.md +12 -0
- package/.agent-src/commands/challenge-me/with-docs.md +12 -0
- package/.agent-src/commands/challenge-me.md +12 -0
- package/.agent-src/commands/chat-history/import.md +16 -4
- package/.agent-src/commands/chat-history/learn.md +15 -3
- package/.agent-src/commands/chat-history/show.md +17 -5
- package/.agent-src/commands/chat-history.md +14 -2
- package/.agent-src/commands/check-current-md.md +12 -0
- package/.agent-src/commands/commit/in-chunks.md +12 -0
- package/.agent-src/commands/commit.md +12 -0
- package/.agent-src/commands/compress.md +12 -0
- package/.agent-src/commands/context/create.md +17 -5
- package/.agent-src/commands/context/refactor.md +15 -3
- package/.agent-src/commands/context.md +12 -0
- package/.agent-src/commands/cost-report.md +12 -0
- package/.agent-src/commands/council/analysis.md +15 -3
- package/.agent-src/commands/council/debate.md +17 -5
- package/.agent-src/commands/council/default.md +17 -5
- package/.agent-src/commands/council/design.md +12 -0
- package/.agent-src/commands/council/optimize.md +12 -0
- package/.agent-src/commands/council/pr.md +12 -0
- package/.agent-src/commands/council.md +13 -1
- package/.agent-src/commands/create-pr/description-only.md +12 -0
- package/.agent-src/commands/create-pr.md +39 -0
- package/.agent-src/commands/e2e-heal.md +12 -0
- package/.agent-src/commands/e2e-plan.md +12 -0
- package/.agent-src/commands/estimate-ticket.md +12 -0
- package/.agent-src/commands/feature/dev.md +13 -1
- package/.agent-src/commands/feature/explore.md +12 -0
- package/.agent-src/commands/feature/plan.md +14 -2
- package/.agent-src/commands/feature/refactor.md +12 -0
- package/.agent-src/commands/feature/roadmap.md +12 -0
- package/.agent-src/commands/feature.md +12 -0
- package/.agent-src/commands/fix/ci.md +12 -0
- package/.agent-src/commands/fix/portability.md +12 -0
- package/.agent-src/commands/fix/pr-bot-comments.md +12 -0
- package/.agent-src/commands/fix/pr-comments.md +12 -0
- package/.agent-src/commands/fix/pr-developer-comments.md +12 -0
- package/.agent-src/commands/fix/refs.md +12 -0
- package/.agent-src/commands/fix/seeder.md +12 -0
- package/.agent-src/commands/fix.md +12 -0
- package/.agent-src/commands/ghostwriter/delete.md +20 -8
- package/.agent-src/commands/ghostwriter/fetch.md +19 -7
- package/.agent-src/commands/ghostwriter/list.md +19 -7
- package/.agent-src/commands/ghostwriter/show.md +14 -2
- package/.agent-src/commands/ghostwriter/write.md +15 -3
- package/.agent-src/commands/ghostwriter.md +14 -2
- package/.agent-src/commands/grill-me.md +12 -0
- package/.agent-src/commands/implement-ticket.md +12 -0
- package/.agent-src/commands/install-via-agent.md +129 -0
- package/.agent-src/commands/jira-ticket.md +12 -0
- package/.agent-src/commands/judge/on-diff.md +12 -0
- package/.agent-src/commands/judge/solo.md +12 -0
- package/.agent-src/commands/judge/steps.md +12 -0
- package/.agent-src/commands/judge.md +12 -0
- package/.agent-src/commands/memory/add.md +12 -0
- package/.agent-src/commands/memory/learn-low-impact.md +18 -6
- package/.agent-src/commands/memory/load.md +12 -0
- package/.agent-src/commands/memory/mine-session.md +12 -0
- package/.agent-src/commands/memory/promote.md +12 -0
- package/.agent-src/commands/memory/propose.md +12 -0
- package/.agent-src/commands/memory.md +12 -0
- package/.agent-src/commands/mode.md +12 -0
- package/.agent-src/commands/module/create.md +12 -0
- package/.agent-src/commands/module/explore.md +13 -1
- package/.agent-src/commands/module.md +12 -0
- package/.agent-src/commands/optimize/agents-dir.md +14 -2
- package/.agent-src/commands/optimize/augmentignore.md +12 -0
- package/.agent-src/commands/optimize/rtk.md +12 -0
- package/.agent-src/commands/optimize/skills.md +12 -0
- package/.agent-src/commands/optimize-prompt.md +12 -0
- package/.agent-src/commands/optimize.md +12 -0
- package/.agent-src/commands/orchestrate.md +13 -1
- package/.agent-src/commands/override/create.md +12 -0
- package/.agent-src/commands/override/manage.md +12 -0
- package/.agent-src/commands/override.md +12 -0
- package/.agent-src/commands/package-reset.md +12 -0
- package/.agent-src/commands/package-test.md +12 -0
- package/.agent-src/commands/post-as/ghostwriter.md +12 -0
- package/.agent-src/commands/post-as/me.md +13 -1
- package/.agent-src/commands/post-as.md +12 -0
- package/.agent-src/commands/prepare-for-review.md +12 -0
- package/.agent-src/commands/project-analyze.md +27 -15
- package/.agent-src/commands/project-health.md +13 -1
- package/.agent-src/commands/quality-fix.md +12 -0
- package/.agent-src/commands/refine-ticket.md +12 -0
- package/.agent-src/commands/research/deep.md +12 -0
- package/.agent-src/commands/research/report.md +12 -0
- package/.agent-src/commands/research.md +12 -0
- package/.agent-src/commands/review-changes.md +12 -0
- package/.agent-src/commands/review-routing.md +12 -0
- package/.agent-src/commands/roadmap/ai-council.md +15 -3
- package/.agent-src/commands/roadmap/create.md +13 -1
- package/.agent-src/commands/roadmap/process-full.md +12 -0
- package/.agent-src/commands/roadmap/process-phase.md +12 -0
- package/.agent-src/commands/roadmap/process-step.md +12 -0
- package/.agent-src/commands/roadmap.md +12 -0
- package/.agent-src/commands/rule-compliance-audit.md +12 -0
- package/.agent-src/commands/set-cost-profile.md +12 -0
- package/.agent-src/commands/sync-agent-settings.md +12 -0
- package/.agent-src/commands/sync-gitignore/fix.md +32 -13
- package/.agent-src/commands/sync-gitignore.md +13 -1
- package/.agent-src/commands/tests/create.md +12 -0
- package/.agent-src/commands/tests/execute.md +12 -0
- package/.agent-src/commands/tests.md +12 -0
- package/.agent-src/commands/threat-model.md +12 -0
- package/.agent-src/commands/update-form-request-messages.md +12 -0
- package/.agent-src/commands/upstream-contribute.md +12 -0
- package/.agent-src/commands/video/from-script.md +13 -1
- package/.agent-src/commands/video/scene.md +12 -0
- package/.agent-src/commands/video/stitch.md +13 -1
- package/.agent-src/commands/video/storyboard.md +12 -0
- package/.agent-src/commands/video.md +13 -1
- package/.agent-src/commands/work.md +12 -0
- package/.agent-src/contexts/augment-infrastructure.md +2 -2
- package/.agent-src/contexts/authority/scope-mechanics.md +11 -0
- package/.agent-src/contexts/contracts/agents-md-anatomy.md +1 -1
- package/.agent-src/contexts/documentation-hierarchy.md +2 -2
- package/.agent-src/contexts/execution/cheap-question-mechanics.md +81 -0
- package/.agent-src/contexts/execution/roadmap-process-loop.md +19 -0
- package/.agent-src/ghostwriter/README.md +2 -2
- package/.agent-src/ghostwriter/fictional-fixture-v1.md +1 -1
- package/.agent-src/personas/README.md +1 -1
- package/.agent-src/personas/advisors/contrarian.md +1 -1
- package/.agent-src/personas/advisors/executor.md +1 -1
- package/.agent-src/personas/advisors/expansionist.md +1 -1
- package/.agent-src/personas/advisors/first-principles.md +1 -1
- package/.agent-src/personas/advisors/outsider.md +1 -1
- package/.agent-src/rules/agent-authority.md +12 -0
- package/.agent-src/rules/analysis-skill-routing.md +12 -0
- package/.agent-src/rules/architecture.md +13 -1
- package/.agent-src/rules/artifact-drafting-protocol.md +13 -1
- package/.agent-src/rules/artifact-engagement-recording.md +13 -1
- package/.agent-src/rules/ask-when-uncertain.md +12 -0
- package/.agent-src/rules/augment-edit-discipline.md +13 -1
- package/.agent-src/rules/augment-source-of-truth.md +13 -1
- package/.agent-src/rules/autonomous-execution.md +13 -1
- package/.agent-src/rules/caveman-speak.md +15 -3
- package/.agent-src/rules/cli-output-handling.md +13 -1
- package/.agent-src/rules/command-suggestion-policy.md +13 -1
- package/.agent-src/rules/commit-conventions.md +13 -1
- package/.agent-src/rules/commit-policy.md +12 -0
- package/.agent-src/rules/context-hygiene.md +51 -3
- package/.agent-src/rules/copilot-routing.md +13 -1
- package/.agent-src/rules/devcontainer-routing.md +13 -1
- package/.agent-src/rules/direct-answers.md +12 -0
- package/.agent-src/rules/docker-commands.md +13 -1
- package/.agent-src/rules/domain-adoption-policy.md +17 -5
- package/.agent-src/rules/domain-safety-disclaimer.md +13 -1
- package/.agent-src/rules/domain-safety-pii.md +13 -1
- package/.agent-src/rules/domain-safety-retention.md +13 -1
- package/.agent-src/rules/downstream-changes.md +13 -1
- package/.agent-src/rules/engineering-safety-floor.md +102 -0
- package/.agent-src/rules/external-reference-deep-dive.md +13 -1
- package/.agent-src/rules/fast-path-marker-visibility.md +21 -1
- package/.agent-src/rules/finance-safety-floor.md +114 -0
- package/.agent-src/rules/framework-neutrality-in-generic-skills.md +13 -1
- package/.agent-src/rules/git-history-discipline.md +14 -2
- package/.agent-src/rules/guidelines.md +12 -0
- package/.agent-src/rules/improve-before-implement.md +13 -1
- package/.agent-src/rules/invite-challenge.md +13 -1
- package/.agent-src/rules/language-and-tone.md +12 -0
- package/.agent-src/rules/laravel-routing.md +13 -1
- package/.agent-src/rules/laravel-translations.md +13 -1
- package/.agent-src/rules/low-impact-corpus-privacy-floor.md +17 -5
- package/.agent-src/rules/markdown-safe-codeblocks.md +13 -1
- package/.agent-src/rules/media-governance-routing.md +27 -15
- package/.agent-src/rules/minimal-safe-diff.md +13 -1
- package/.agent-src/rules/missing-tool-handling.md +13 -1
- package/.agent-src/rules/model-recommendation.md +13 -1
- package/.agent-src/rules/no-attribution-footers.md +13 -1
- package/.agent-src/rules/no-cheap-questions.md +46 -32
- package/.agent-src/rules/no-roadmap-references.md +28 -16
- package/.agent-src/rules/non-destructive-by-default.md +12 -0
- package/.agent-src/rules/onboarding-gate.md +19 -6
- package/.agent-src/rules/package-ci-checks.md +12 -0
- package/.agent-src/rules/persona-governance.md +13 -1
- package/.agent-src/rules/php-coding.md +13 -1
- package/.agent-src/rules/preservation-guard.md +13 -1
- package/.agent-src/rules/provider-lifecycle-discipline.md +18 -6
- package/.agent-src/rules/reviewer-awareness.md +13 -1
- package/.agent-src/rules/roadmap-ci-steps-policy.md +13 -1
- package/.agent-src/rules/roadmap-progress-sync.md +18 -1
- package/.agent-src/rules/role-mode-adherence.md +13 -1
- package/.agent-src/rules/rule-type-governance.md +13 -1
- package/.agent-src/rules/runtime-safety.md +13 -1
- package/.agent-src/rules/scope-control.md +12 -0
- package/.agent-src/rules/security-sensitive-stop.md +13 -1
- package/.agent-src/rules/size-enforcement.md +12 -0
- package/.agent-src/rules/skill-improvement-trigger.md +13 -1
- package/.agent-src/rules/skill-quality.md +13 -1
- package/.agent-src/rules/slash-command-routing-policy.md +13 -1
- package/.agent-src/rules/strategy-safety-floor.md +114 -0
- package/.agent-src/rules/symfony-routing.md +13 -1
- package/.agent-src/rules/think-before-action.md +13 -1
- package/.agent-src/rules/token-efficiency.md +13 -1
- package/.agent-src/rules/token-optimizer-maintenance.md +12 -0
- package/.agent-src/rules/tool-safety.md +13 -1
- package/.agent-src/rules/ui-audit-gate.md +13 -1
- package/.agent-src/rules/upstream-proposal.md +13 -1
- package/.agent-src/rules/user-interaction.md +13 -1
- package/.agent-src/rules/user-interrupt-priority.md +12 -0
- package/.agent-src/rules/verify-before-complete.md +12 -0
- package/.agent-src/skills/accessibility-auditor/SKILL.md +12 -0
- package/.agent-src/skills/activation-design/SKILL.md +12 -0
- package/.agent-src/skills/adr-create/SKILL.md +12 -0
- package/.agent-src/skills/adversarial-review/SKILL.md +12 -0
- package/.agent-src/skills/agent-docs-writing/SKILL.md +16 -4
- package/.agent-src/skills/agents-md-thin-root/SKILL.md +28 -10
- package/.agent-src/skills/ai-council/SKILL.md +28 -15
- package/.agent-src/skills/analysis-autonomous-mode/SKILL.md +12 -0
- package/.agent-src/skills/analysis-skill-router/SKILL.md +12 -0
- package/.agent-src/skills/api-design/SKILL.md +13 -3
- package/.agent-src/skills/api-endpoint/SKILL.md +12 -0
- package/.agent-src/skills/api-testing/SKILL.md +12 -0
- package/.agent-src/skills/architecture-review-lens/SKILL.md +12 -0
- package/.agent-src/skills/artisan-commands/SKILL.md +12 -0
- package/.agent-src/skills/async-python-patterns/SKILL.md +13 -1
- package/.agent-src/skills/authz-review/SKILL.md +12 -2
- package/.agent-src/skills/aws-infrastructure/SKILL.md +12 -0
- package/.agent-src/skills/blade-ui/SKILL.md +12 -0
- package/.agent-src/skills/blast-radius-analyzer/SKILL.md +12 -0
- package/.agent-src/skills/bug-analyzer/SKILL.md +14 -2
- package/.agent-src/skills/build-buy-partner/SKILL.md +12 -0
- package/.agent-src/skills/canvas-design/SKILL.md +12 -0
- package/.agent-src/skills/character-consistency/SKILL.md +23 -11
- package/.agent-src/skills/check-refs/SKILL.md +12 -0
- package/.agent-src/skills/churn-prevention/SKILL.md +12 -0
- package/.agent-src/skills/code-refactoring/SKILL.md +16 -4
- package/.agent-src/skills/code-review/SKILL.md +12 -0
- package/.agent-src/skills/command-routing/SKILL.md +12 -0
- package/.agent-src/skills/command-writing/SKILL.md +14 -2
- package/.agent-src/skills/comp-banding/SKILL.md +12 -0
- package/.agent-src/skills/competitive-moat-analysis/SKILL.md +12 -2
- package/.agent-src/skills/competitive-positioning/SKILL.md +12 -2
- package/.agent-src/skills/composer-packages/SKILL.md +12 -0
- package/.agent-src/skills/compress-memory/SKILL.md +12 -0
- package/.agent-src/skills/content-funnel-design/SKILL.md +12 -2
- package/.agent-src/skills/context-authoring/SKILL.md +18 -6
- package/.agent-src/skills/context-document/SKILL.md +17 -5
- package/.agent-src/skills/contracts-cognition/SKILL.md +12 -2
- package/.agent-src/skills/conventional-commits-writing/SKILL.md +12 -0
- package/.agent-src/skills/copilot-agents-optimization/SKILL.md +13 -1
- package/.agent-src/skills/copilot-config/SKILL.md +12 -0
- package/.agent-src/skills/customer-research/SKILL.md +12 -0
- package/.agent-src/skills/dashboard-design/SKILL.md +12 -0
- package/.agent-src/skills/data-flow-mapper/SKILL.md +12 -0
- package/.agent-src/skills/data-handling-judgment/SKILL.md +12 -2
- package/.agent-src/skills/database/SKILL.md +14 -2
- package/.agent-src/skills/dcf-modeling/SKILL.md +12 -2
- package/.agent-src/skills/deal-qualification-meddic/SKILL.md +12 -2
- package/.agent-src/skills/decision-record/SKILL.md +12 -0
- package/.agent-src/skills/deep-reading-analyst/SKILL.md +12 -0
- package/.agent-src/skills/defense-in-depth/SKILL.md +13 -1
- package/.agent-src/skills/dependency-upgrade/SKILL.md +12 -0
- package/.agent-src/skills/description-assist/SKILL.md +12 -0
- package/.agent-src/skills/design-review/SKILL.md +12 -0
- package/.agent-src/skills/devcontainer/SKILL.md +12 -0
- package/.agent-src/skills/developer-like-execution/SKILL.md +12 -0
- package/.agent-src/skills/discovery-interview/SKILL.md +12 -2
- package/.agent-src/skills/doc-coauthoring/SKILL.md +12 -0
- package/.agent-src/skills/docker/SKILL.md +12 -0
- package/.agent-src/skills/editorial-calendar/SKILL.md +12 -2
- package/.agent-src/skills/eloquent/SKILL.md +12 -0
- package/.agent-src/skills/eloquent/evals/triggers.json +1 -1
- package/.agent-src/skills/error-handling-patterns/SKILL.md +13 -1
- package/.agent-src/skills/estimate-ticket/SKILL.md +12 -0
- package/.agent-src/skills/existing-ui-audit/SKILL.md +12 -0
- package/.agent-src/skills/expansion-playbook/SKILL.md +12 -0
- package/.agent-src/skills/fe-design/SKILL.md +12 -0
- package/.agent-src/skills/feature-planning/SKILL.md +12 -0
- package/.agent-src/skills/file-editor/SKILL.md +12 -0
- package/.agent-src/skills/finishing-a-development-branch/SKILL.md +12 -0
- package/.agent-src/skills/flux/SKILL.md +12 -0
- package/.agent-src/skills/forecast-accuracy/SKILL.md +12 -2
- package/.agent-src/skills/forecasting/SKILL.md +12 -2
- package/.agent-src/skills/form-handler/SKILL.md +12 -0
- package/.agent-src/skills/fundraising-narrative/SKILL.md +12 -2
- package/.agent-src/skills/funnel-analysis/SKILL.md +12 -0
- package/.agent-src/skills/git-workflow/SKILL.md +12 -0
- package/.agent-src/skills/github-ci/SKILL.md +12 -0
- package/.agent-src/skills/grafana/SKILL.md +12 -0
- package/.agent-src/skills/gtm-launch/SKILL.md +12 -2
- package/.agent-src/skills/guideline-writing/SKILL.md +12 -0
- package/.agent-src/skills/hiring-loop-design/SKILL.md +12 -0
- package/.agent-src/skills/incident-commander/SKILL.md +12 -2
- package/.agent-src/skills/jira-integration/SKILL.md +12 -0
- package/.agent-src/skills/jobs-events/SKILL.md +12 -0
- package/.agent-src/skills/judge-bug-hunter/SKILL.md +12 -0
- package/.agent-src/skills/judge-code-quality/SKILL.md +12 -0
- package/.agent-src/skills/judge-security-auditor/SKILL.md +12 -0
- package/.agent-src/skills/judge-test-coverage/SKILL.md +12 -0
- package/.agent-src/skills/laravel/SKILL.md +12 -0
- package/.agent-src/skills/laravel-api-endpoint/SKILL.md +15 -3
- package/.agent-src/skills/laravel-dto/SKILL.md +14 -2
- package/.agent-src/skills/laravel-horizon/SKILL.md +12 -0
- package/.agent-src/skills/laravel-mail/SKILL.md +12 -0
- package/.agent-src/skills/laravel-middleware/SKILL.md +12 -0
- package/.agent-src/skills/laravel-migration/SKILL.md +12 -0
- package/.agent-src/skills/laravel-notifications/SKILL.md +12 -0
- package/.agent-src/skills/laravel-pennant/SKILL.md +12 -0
- package/.agent-src/skills/laravel-pulse/SKILL.md +12 -0
- package/.agent-src/skills/laravel-reverb/SKILL.md +12 -0
- package/.agent-src/skills/laravel-scheduling/SKILL.md +12 -0
- package/.agent-src/skills/laravel-validation/SKILL.md +12 -0
- package/.agent-src/skills/laravel-websocket/SKILL.md +12 -0
- package/.agent-src/skills/launch-readiness/SKILL.md +12 -2
- package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +15 -3
- package/.agent-src/skills/lint-skills/SKILL.md +12 -0
- package/.agent-src/skills/livewire/SKILL.md +12 -0
- package/.agent-src/skills/livewire-architect/SKILL.md +12 -0
- package/.agent-src/skills/logging-monitoring/SKILL.md +12 -0
- package/.agent-src/skills/market-entry-analysis/SKILL.md +12 -0
- package/.agent-src/skills/markitdown/SKILL.md +14 -2
- package/.agent-src/skills/mcp/SKILL.md +12 -0
- package/.agent-src/skills/mcp-builder/SKILL.md +14 -2
- package/.agent-src/skills/md-language-check/SKILL.md +13 -1
- package/.agent-src/skills/memory-consolidation/SKILL.md +12 -0
- package/.agent-src/skills/merge-conflicts/SKILL.md +12 -0
- package/.agent-src/skills/messaging-architecture/SKILL.md +12 -2
- package/.agent-src/skills/migration-architect/SKILL.md +12 -0
- package/.agent-src/skills/mobile-e2e-strategy/SKILL.md +12 -0
- package/.agent-src/skills/module-management/SKILL.md +12 -0
- package/.agent-src/skills/motion-choreographer/SKILL.md +16 -4
- package/.agent-src/skills/multi-tenancy/SKILL.md +14 -2
- package/.agent-src/skills/nextjs-patterns/SKILL.md +12 -0
- package/.agent-src/skills/okr-tree-modeling/SKILL.md +12 -2
- package/.agent-src/skills/onboarding-design/SKILL.md +12 -0
- package/.agent-src/skills/onboarding-program/SKILL.md +12 -0
- package/.agent-src/skills/one-on-one-cadence/SKILL.md +12 -0
- package/.agent-src/skills/openapi/SKILL.md +13 -1
- package/.agent-src/skills/org-design/SKILL.md +12 -0
- package/.agent-src/skills/override-management/SKILL.md +12 -0
- package/.agent-src/skills/perf-feedback-craft/SKILL.md +12 -0
- package/.agent-src/skills/performance/SKILL.md +12 -0
- package/.agent-src/skills/performance-analysis/SKILL.md +12 -0
- package/.agent-src/skills/persona-writing/SKILL.md +12 -0
- package/.agent-src/skills/pest-testing/SKILL.md +12 -0
- package/.agent-src/skills/php-coder/SKILL.md +12 -0
- package/.agent-src/skills/php-debugging/SKILL.md +12 -0
- package/.agent-src/skills/php-service/SKILL.md +12 -0
- package/.agent-src/skills/pipeline-strategy/SKILL.md +12 -2
- package/.agent-src/skills/pixar-storyteller/SKILL.md +17 -5
- package/.agent-src/skills/playwright-architect/SKILL.md +12 -2
- package/.agent-src/skills/playwright-testing/SKILL.md +12 -0
- package/.agent-src/skills/po-discovery/SKILL.md +12 -0
- package/.agent-src/skills/positioning-strategy/SKILL.md +12 -0
- package/.agent-src/skills/privacy-review/SKILL.md +12 -2
- package/.agent-src/skills/project-analysis-core/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-hypothesis-driven/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-laravel/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-nextjs/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-node-express/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-react/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-symfony/SKILL.md +12 -0
- package/.agent-src/skills/project-analysis-zend-laminas/SKILL.md +12 -0
- package/.agent-src/skills/project-analyzer/SKILL.md +30 -18
- package/.agent-src/skills/project-docs/SKILL.md +25 -13
- package/.agent-src/skills/prompt-engineering-patterns/SKILL.md +13 -1
- package/.agent-src/skills/prompt-optimizer/SKILL.md +13 -1
- package/.agent-src/skills/quality-tools/SKILL.md +12 -2
- package/.agent-src/skills/react-native-setup/SKILL.md +12 -0
- package/.agent-src/skills/react-shadcn-ui/SKILL.md +12 -0
- package/.agent-src/skills/readme-reviewer/SKILL.md +64 -3
- package/.agent-src/skills/readme-writing/SKILL.md +64 -4
- package/.agent-src/skills/readme-writing-package/SKILL.md +60 -5
- package/.agent-src/skills/receiving-code-review/SKILL.md +12 -0
- package/.agent-src/skills/refine-prompt/SKILL.md +13 -1
- package/.agent-src/skills/refine-ticket/SKILL.md +14 -2
- package/.agent-src/skills/refine-ticket/detection-map.yml +2 -2
- package/.agent-src/skills/release-comms/SKILL.md +12 -2
- package/.agent-src/skills/repomix-packer/SKILL.md +13 -1
- package/.agent-src/skills/requesting-code-review/SKILL.md +12 -0
- package/.agent-src/skills/retention-loops/SKILL.md +12 -0
- package/.agent-src/skills/review-routing/SKILL.md +12 -0
- package/.agent-src/skills/rice-prioritization/SKILL.md +12 -0
- package/.agent-src/skills/risk-officer/SKILL.md +12 -0
- package/.agent-src/skills/roadmap-management/SKILL.md +12 -0
- package/.agent-src/skills/roadmap-writing/SKILL.md +12 -0
- package/.agent-src/skills/rtk-output-filtering/SKILL.md +12 -0
- package/.agent-src/skills/rule-refactor/SKILL.md +15 -3
- package/.agent-src/skills/rule-writing/SKILL.md +13 -1
- package/.agent-src/skills/runway-cognition/SKILL.md +12 -2
- package/.agent-src/skills/scenario-modeling/SKILL.md +12 -2
- package/.agent-src/skills/scene-expander/SKILL.md +18 -6
- package/.agent-src/skills/script-writing/SKILL.md +13 -1
- package/.agent-src/skills/secrets-management/SKILL.md +13 -3
- package/.agent-src/skills/security/SKILL.md +12 -0
- package/.agent-src/skills/security-audit/SKILL.md +12 -0
- package/.agent-src/skills/sentry-integration/SKILL.md +12 -0
- package/.agent-src/skills/sequential-thinking/SKILL.md +12 -0
- package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +12 -0
- package/.agent-src/skills/skill-management/SKILL.md +12 -0
- package/.agent-src/skills/skill-reviewer/SKILL.md +12 -0
- package/.agent-src/skills/skill-writing/SKILL.md +12 -0
- package/.agent-src/skills/sql-writing/SKILL.md +12 -0
- package/.agent-src/skills/stakeholder-tradeoff/SKILL.md +12 -0
- package/.agent-src/skills/subagent-orchestration/SKILL.md +13 -1
- package/.agent-src/skills/symfony-workflow/SKILL.md +12 -0
- package/.agent-src/skills/systematic-debugging/SKILL.md +53 -0
- package/.agent-src/skills/tailwind-engineer/SKILL.md +12 -0
- package/.agent-src/skills/tech-debt-tracker/SKILL.md +12 -2
- package/.agent-src/skills/technical-specification/SKILL.md +12 -0
- package/.agent-src/skills/terraform/SKILL.md +12 -0
- package/.agent-src/skills/terragrunt/SKILL.md +12 -0
- package/.agent-src/skills/test-driven-development/SKILL.md +12 -0
- package/.agent-src/skills/test-performance/SKILL.md +13 -1
- package/.agent-src/skills/testing-anti-patterns/SKILL.md +13 -1
- package/.agent-src/skills/threat-modeling/SKILL.md +12 -0
- package/.agent-src/skills/throughput-vs-morale-tradeoff/SKILL.md +12 -0
- package/.agent-src/skills/token-optimizer/SKILL.md +12 -0
- package/.agent-src/skills/traefik/SKILL.md +12 -0
- package/.agent-src/skills/ui-component-architect/SKILL.md +12 -0
- package/.agent-src/skills/unit-economics-modeling/SKILL.md +12 -2
- package/.agent-src/skills/universal-project-analysis/SKILL.md +12 -0
- package/.agent-src/skills/upstream-contribute/SKILL.md +12 -0
- package/.agent-src/skills/using-git-worktrees/SKILL.md +12 -0
- package/.agent-src/skills/validate-feature-fit/SKILL.md +12 -0
- package/.agent-src/skills/verify-completion-evidence/SKILL.md +12 -0
- package/.agent-src/skills/video-director/SKILL.md +18 -6
- package/.agent-src/skills/vision-articulation/SKILL.md +12 -0
- package/.agent-src/skills/voc-extract/SKILL.md +12 -2
- package/.agent-src/skills/voice-and-tone-design/SKILL.md +12 -2
- package/.agent-src/templates/agent-settings.md +5 -5
- package/.agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/.agent-src/templates/agents/memory/ownership.example.yml +1 -1
- package/.agent-src/templates/agents/proposal.example.md +12 -0
- package/.agent-src/templates/command.md +1 -1
- package/.agent-src/templates/contexts/auth-model.md +2 -2
- package/.agent-src/templates/contexts/data-sensitivity.md +3 -3
- package/.agent-src/templates/contexts/deployment-order.md +2 -2
- package/.agent-src/templates/contexts/observability.md +3 -3
- package/.agent-src/templates/contexts/tenant-boundaries.md +3 -3
- package/.agent-src/templates/contexts.md +1 -1
- package/.agent-src/templates/hooks/pre-commit-frontmatter +66 -0
- package/.agent-src/templates/hooks/pre-commit-roadmap-progress +78 -39
- package/.agent-src/templates/rule.md +1 -1
- package/.agent-src/templates/scripts/work_engine/_lib/agent_settings.py +7 -4
- package/.agent-src/templates/scripts/work_engine/cli.py +6 -6
- package/.agent-src/templates/scripts/work_engine/emitters.py +29 -4
- package/.agent-src/templates/scripts/work_engine/hooks/builtin/decision_trace.py +3 -3
- package/.agent-src/templates/scripts/work_engine/orchestration.py +25 -11
- package/.agent-src/templates/scripts/work_engine/state.py +53 -0
- package/.agent-src/templates/skill-archive-note.md +4 -4
- package/.claude-plugin/marketplace.json +2 -2
- package/AGENTS.md +12 -9
- package/CHANGELOG.md +268 -90
- package/CONTRIBUTING.md +61 -0
- package/README.md +173 -558
- package/config/agent-settings.template.yml +11 -8
- package/config/discovery/packs.yml +162 -0
- package/config/discovery/unassigned-artefacts.yml +68 -0
- package/config/discovery/workspaces.yml +59 -0
- package/config/gitignore-block.txt +36 -23
- package/dist/cli/agent-config.js +199 -0
- package/dist/cli/agent-config.js.map +1 -0
- package/dist/cli/bash/runBash.js +40 -0
- package/dist/cli/bash/runBash.js.map +1 -0
- package/dist/cli/commands/doctorShell.js +91 -0
- package/dist/cli/commands/doctorShell.js.map +1 -0
- package/dist/cli/commands/packs.js +59 -0
- package/dist/cli/commands/packs.js.map +1 -0
- package/dist/cli/commands/settings.js +35 -0
- package/dist/cli/commands/settings.js.map +1 -0
- package/dist/cli/commands/uiServe.js +119 -0
- package/dist/cli/commands/uiServe.js.map +1 -0
- package/dist/cli/commands/versions.js +64 -0
- package/dist/cli/commands/versions.js.map +1 -0
- package/dist/cli/commands/workspaces.js +58 -0
- package/dist/cli/commands/workspaces.js.map +1 -0
- package/dist/cli/discovery/loadManifest.js +62 -0
- package/dist/cli/discovery/loadManifest.js.map +1 -0
- package/dist/cli/log/logger.js +41 -0
- package/dist/cli/log/logger.js.map +1 -0
- package/dist/cli/paths.js +60 -0
- package/dist/cli/paths.js.map +1 -0
- package/dist/cli/python/resolvePython.js +38 -0
- package/dist/cli/python/resolvePython.js.map +1 -0
- package/dist/cli/registry.js +77 -0
- package/dist/cli/registry.js.map +1 -0
- package/dist/discovery/deprecation-report.md +7 -0
- package/dist/discovery/discovery-manifest.json +9893 -0
- package/dist/discovery/discovery-manifest.json.sha256 +1 -0
- package/dist/discovery/discovery-manifest.summary.md +93 -0
- package/dist/discovery/orphan-report.md +10 -0
- package/dist/discovery/packs.json +1002 -0
- package/dist/discovery/trust-report.md +26 -0
- package/dist/discovery/workspaces.json +705 -0
- package/dist/mcp/awesome-mcp-servers.row.md +1 -0
- package/dist/mcp/mcp-cloudflare-catalogue.json +27 -0
- package/dist/mcp/registry-manifest.json +63 -0
- package/dist/router.json +1623 -0
- package/dist/server/app.js +125 -0
- package/dist/server/app.js.map +1 -0
- package/dist/server/io/atomicMultiWrite.js +204 -0
- package/dist/server/io/atomicMultiWrite.js.map +1 -0
- package/dist/server/io/atomicWrite.js +79 -0
- package/dist/server/io/atomicWrite.js.map +1 -0
- package/dist/server/io/substituteTemplate.js +87 -0
- package/dist/server/io/substituteTemplate.js.map +1 -0
- package/dist/server/io/yamlIO.js +162 -0
- package/dist/server/io/yamlIO.js.map +1 -0
- package/dist/server/port.js +97 -0
- package/dist/server/port.js.map +1 -0
- package/dist/server/routes/discovery.js +72 -0
- package/dist/server/routes/discovery.js.map +1 -0
- package/dist/server/routes/ping.js +57 -0
- package/dist/server/routes/ping.js.map +1 -0
- package/dist/server/routes/schema.js +41 -0
- package/dist/server/routes/schema.js.map +1 -0
- package/dist/server/routes/settings.js +236 -0
- package/dist/server/routes/settings.js.map +1 -0
- package/dist/server/routes/userMd.js +127 -0
- package/dist/server/routes/userMd.js.map +1 -0
- package/dist/server/routes/wizard.js +374 -0
- package/dist/server/routes/wizard.js.map +1 -0
- package/dist/server/schemas/settings.js +137 -0
- package/dist/server/schemas/settings.js.map +1 -0
- package/dist/server/token.js +75 -0
- package/dist/server/token.js.map +1 -0
- package/dist/server/writeRoot.js +84 -0
- package/dist/server/writeRoot.js.map +1 -0
- package/dist/server/writeRoot.test.js +91 -0
- package/dist/server/writeRoot.test.js.map +1 -0
- package/dist/shared/userMd/formAdapter.js +83 -0
- package/dist/shared/userMd/formAdapter.js.map +1 -0
- package/dist/shared/userMd/schema.js +46 -0
- package/dist/shared/userMd/schema.js.map +1 -0
- package/dist/shared/userMd/utils.js +88 -0
- package/dist/shared/userMd/utils.js.map +1 -0
- package/dist/ui/assets/index-D-DY1ywI.js +35 -0
- package/dist/ui/assets/index-D-DY1ywI.js.map +1 -0
- package/dist/ui/assets/index-Dqfhmg-d.css +1 -0
- package/dist/ui/index.html +14 -0
- package/docs/adrs/caveman/0001-default-off-until-bench.md +2 -2
- package/docs/adrs/cost/0001-hard-stop-hook.md +1 -1
- package/docs/adrs/router/0001-three-tier-routing.md +5 -5
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +4 -4
- package/docs/adrs/schema/README.md +1 -1
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +3 -3
- package/docs/architecture/setup-vs-settings-shared-surface.md +114 -0
- package/docs/architecture.md +3 -2
- package/docs/archive/CHANGELOG-pre-2.2.0.md +7 -7
- package/docs/archive/CHANGELOG-pre-3.0.0.md +130 -0
- package/docs/archive/CHANGELOG-pre-3.1.0.md +167 -0
- package/docs/catalog.md +92 -100
- package/docs/contracts/CHANGELOG-conventions.md +1 -1
- package/docs/contracts/STABILITY.md +1 -1
- package/docs/contracts/adr-architectural-consensus-mechanism.md +5 -5
- package/docs/contracts/adr-chat-history-split.md +1 -1
- package/docs/contracts/adr-implement-ticket-runtime.md +1 -1
- package/docs/contracts/adr-install-user-type-axis.md +1 -1
- package/docs/contracts/adr-mcp-runtime.md +2 -2
- package/docs/contracts/agent-user-schema.md +17 -11
- package/docs/contracts/ai-council-config.md +13 -13
- package/docs/contracts/audit-log-v1.md +2 -2
- package/docs/contracts/command-clusters.md +2 -2
- package/docs/contracts/compression-default-kill-criterion.md +3 -3
- package/docs/contracts/consumer-bridge.md +79 -0
- package/docs/contracts/decision-trace-v1.md +5 -5
- package/docs/contracts/discovery-manifest.md +209 -0
- package/docs/contracts/discovery-manifest.schema.json +219 -0
- package/docs/contracts/explain-trace.schema.json +144 -0
- package/docs/contracts/file-ownership-matrix.json +288 -328
- package/docs/contracts/file-ownership-matrix.md +1 -1
- package/docs/contracts/frontmatter-contract.md +140 -0
- package/docs/contracts/ghostwriter-schema.md +3 -3
- package/docs/contracts/gui-wizard.md +223 -0
- package/docs/contracts/hook-architecture-v1.md +10 -10
- package/docs/contracts/installer-agent-mode.md +137 -0
- package/docs/contracts/kernel-membership.md +5 -5
- package/docs/contracts/linter-structural-model.md +3 -3
- package/docs/contracts/load-context-schema.md +5 -5
- package/docs/contracts/local-server-api.md +134 -0
- package/docs/contracts/low-impact-corpus-format.md +1 -1
- package/docs/contracts/mcp-cloud-scope.md +2 -2
- package/docs/contracts/mcp-discovery-phase-notice.md +1 -1
- package/docs/contracts/mcp-phase-1-scope.md +5 -4
- package/docs/contracts/mcp-registry-manifest.schema.json +129 -0
- package/docs/contracts/mcp-tool-inventory.md +9 -9
- package/docs/contracts/mcp-tool-stub-envelope.md +1 -1
- package/docs/contracts/memory-visibility-v1.md +2 -2
- package/docs/contracts/multi-tool-projection-fidelity.md +3 -3
- package/docs/contracts/namespace.md +7 -7
- package/docs/contracts/one-off-script-lifecycle.md +1 -1
- package/docs/contracts/package-self-orientation.md +1 -1
- package/docs/contracts/provider-lifecycle.md +7 -7
- package/docs/contracts/router-blending.md +1 -1
- package/docs/contracts/rule-classification.md +2 -2
- package/docs/contracts/rule-router.md +4 -4
- package/docs/contracts/settings-api.md +207 -0
- package/docs/contracts/settings-gui-agent-mode.schema.json +128 -0
- package/docs/contracts/smoke-contracts.md +3 -3
- package/docs/contracts/tier-3-contrib-plugin.md +1 -1
- package/docs/contracts/trust-and-safety.md +144 -0
- package/docs/contracts/universal-skills.md +1 -1
- package/docs/contracts/write-engine.md +1 -1
- package/docs/customization.md +139 -13
- package/docs/decisions/ADR-001-kernel-swap-deferred.md +1 -1
- package/docs/decisions/ADR-002-kernel-bucket-overrides.md +1 -1
- package/docs/decisions/ADR-004-rule-governance-pruning.md +8 -8
- package/docs/decisions/ADR-006-skill-tools-python-pilot.md +5 -5
- package/docs/decisions/ADR-007-agent-discovery-scopes.md +16 -4
- package/docs/decisions/ADR-008-installed-tools-manifest.md +2 -2
- package/docs/decisions/ADR-010-profile-pack-preset-boundary.md +2 -2
- package/docs/decisions/ADR-011-domain-pack-readiness.md +4 -4
- package/docs/decisions/ADR-012-typescript-cli-shell.md +162 -0
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +234 -0
- package/docs/decisions/ADR-014-gui-framework-choice.md +136 -0
- package/docs/decisions/ADR-015-discovery-manifest-contract.md +146 -0
- package/docs/decisions/ADR-016-installer-architecture.md +189 -0
- package/docs/decisions/ADR-017-monorepo-physical-layout.md +261 -0
- package/docs/decisions/ADR-018-trust-and-safety-layer.md +159 -0
- package/docs/decisions/ADR-019-router-json-dist-location.md +124 -0
- package/docs/decisions/ADR-020-global-only-consumer-scope.md +123 -0
- package/docs/decisions/ADR-021-deployment-shape.md +153 -0
- package/docs/decisions/ADR-rule-kernel-and-router.md +2 -2
- package/docs/decisions/INDEX.md +10 -0
- package/docs/deploy/connector-setup.md +129 -0
- package/docs/deploy/env-vars.md +70 -0
- package/docs/deploy/policy-cookbook.md +130 -0
- package/docs/deploy/quickstart.md +112 -0
- package/docs/distribution/mcp-submission-checklist.md +95 -0
- package/docs/distribution/public-install-smoke.md +68 -0
- package/docs/distribution/registries.md +55 -0
- package/docs/distribution/telemetry-privacy.md +128 -0
- package/docs/distribution/telemetry-schema.md +174 -0
- package/docs/distribution/topics-equivalents-decay-policy.md +51 -0
- package/docs/examples/agent-user.example.md +3 -1
- package/docs/featured-skills.md +95 -0
- package/docs/getting-started-by-role.md +19 -1
- package/docs/getting-started.md +5 -4
- package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +1 -1
- package/docs/guidelines/agent-infra/installed-tools-manifest.md +11 -8
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +10 -1
- package/docs/guidelines/agent-infra/rule-type-governance.md +2 -2
- package/docs/guidelines/agent-infra/tool-integration.md +1 -1
- package/docs/guidelines/docs/readme-size-and-splitting.md +53 -1
- package/docs/guidelines/php/api-design.md +1 -1
- package/docs/guidelines/prompt-templates.md +2 -2
- package/docs/hook-payload-capture.md +3 -3
- package/docs/installation.md +39 -18
- package/docs/maintainers/dev-mode.md +105 -0
- package/docs/migrations/commands-1.15.0.md +3 -3
- package/docs/parity/bench-ruflo.json +1 -1
- package/docs/parity/ruflo.md +3 -3
- package/docs/profiles.md +1 -1
- package/docs/quality.md +2 -2
- package/docs/recruits/_template.md +3 -3
- package/docs/setup/enterprise-and-offline.md +3 -3
- package/docs/setup/mcp-server-docker.md +5 -3
- package/docs/setup/per-ide/claude-desktop.md +3 -2
- package/docs/skills-catalog.md +62 -18
- package/docs/wizard.md +156 -0
- package/llms.txt +61 -17
- package/package.json +63 -3
- package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
- package/scripts/_archive/README.md +2 -2
- package/scripts/_archive/_p4_migrate.py +1 -1
- package/scripts/_cli/cmd_doctor.py +155 -7
- package/scripts/_cli/cmd_explain.py +108 -3
- package/scripts/_cli/cmd_migrate.py +2 -2
- package/scripts/_cli/cmd_migrate_to_global.py +415 -0
- package/scripts/_cli/cmd_settings_migrate.py +146 -0
- package/scripts/_cli/explain_last/__init__.py +122 -0
- package/scripts/_cli/explain_last/assumptions.py +59 -0
- package/scripts/_cli/explain_last/council.py +105 -0
- package/scripts/_cli/explain_last/halt.py +44 -0
- package/scripts/_cli/explain_last/inputs.py +125 -0
- package/scripts/_cli/explain_last/memory.py +94 -0
- package/scripts/_cli/explain_last/provider.py +52 -0
- package/scripts/_cli/explain_last/render.py +52 -0
- package/scripts/_cli/explain_last/route.py +59 -0
- package/scripts/_cli/explain_last/scrubber.py +105 -0
- package/scripts/_cli/explain_last/sections/__init__.py +35 -0
- package/scripts/_cli/explain_last/sections/assumptions.py +21 -0
- package/scripts/_cli/explain_last/sections/council.py +27 -0
- package/scripts/_cli/explain_last/sections/halt.py +31 -0
- package/scripts/_cli/explain_last/sections/header.py +24 -0
- package/scripts/_cli/explain_last/sections/inputs.py +27 -0
- package/scripts/_cli/explain_last/sections/memory.py +21 -0
- package/scripts/_cli/explain_last/sections/pack.py +16 -0
- package/scripts/_cli/explain_last/sections/provider.py +26 -0
- package/scripts/_cli/explain_last/sections/route.py +22 -0
- package/scripts/_cli/explain_last/state_loader.py +76 -0
- package/scripts/_dispatch.bash +987 -0
- package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
- package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
- package/scripts/_lib/agent_settings.py +7 -4
- package/scripts/_lib/agent_src.py +157 -0
- package/scripts/_lib/agents_overlay.py +3 -3
- package/scripts/_phase4_bucket.py +210 -0
- package/scripts/agent-config +50 -947
- package/scripts/ai-video/adapters/higgsfield.sh +1 -1
- package/scripts/ai-video/adapters/sora.sh +1 -1
- package/scripts/ai-video/test-pipeline.sh +2 -2
- package/scripts/ai_council/_default_prices.py +5 -5
- package/scripts/ai_council/advisors.py +1 -1
- package/scripts/ai_council/clients.py +2 -2
- package/scripts/ai_council/compile_corpus.py +9 -8
- package/scripts/ai_council/config.py +3 -3
- package/scripts/ai_council/events_log.py +8 -4
- package/scripts/ai_council/low_impact_corpus.py +1 -1
- package/scripts/ai_council/low_impact_intake.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +2 -2
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_optimization.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_tier_retrofit.py +3 -3
- package/scripts/ai_council/pricing.py +8 -7
- package/scripts/ai_council/probation_gate.py +1 -1
- package/scripts/ai_council/redact_low_impact_entry.py +1 -1
- package/scripts/ai_council/session.py +13 -13
- package/scripts/ai_council/shadow_dispatch.py +2 -2
- package/scripts/annotate_discovery.py +149 -0
- package/scripts/audit_adr_coverage.py +1 -1
- package/scripts/audit_auto_rules.py +2 -2
- package/scripts/audit_cloud_compatibility.py +1 -1
- package/scripts/audit_command_surface.py +2 -2
- package/scripts/audit_likelihood.py +4 -4
- package/scripts/audit_overlap.py +3 -3
- package/scripts/audit_skill_descriptions.py +18 -6
- package/scripts/audit_user_type_axis.py +1 -1
- package/scripts/build_discovery_manifest.py +658 -0
- package/scripts/build_mcp_registry_manifest.py +181 -0
- package/scripts/build_rule_trigger_matrix.py +2 -2
- package/scripts/capture_showcase_session.py +1 -1
- package/scripts/chat_history.py +5 -5
- package/scripts/check_always_budget.py +7 -2
- package/scripts/check_artefact_checksums.py +104 -0
- package/scripts/check_cluster_patterns.py +20 -4
- package/scripts/check_command_count_messaging.py +33 -14
- package/scripts/check_council_layout.py +26 -20
- package/scripts/check_council_references.py +53 -14
- package/scripts/check_discovery_determinism.py +70 -0
- package/scripts/check_kernel_rule_bundle.py +2 -2
- package/scripts/check_no_roadmap_refs.py +2 -2
- package/scripts/check_one_off_location.py +1 -1
- package/scripts/check_overlay_cascade_subdirs.py +7 -3
- package/scripts/check_public_links.py +2 -2
- package/scripts/check_references.py +19 -23
- package/scripts/check_release_includes_discovery.py +61 -0
- package/scripts/check_reply_consistency.py +32 -9
- package/scripts/check_template_pin_drift.py +24 -7
- package/scripts/check_token_optimizer_freshness.py +18 -3
- package/scripts/ci_summary.py +2 -2
- package/scripts/ci_time_ratio.py +1 -1
- package/scripts/command_suggester/__init__.py +1 -1
- package/scripts/compile_router.py +34 -2
- package/scripts/compress.py +162 -44
- package/scripts/config/presets.py +19 -1
- package/scripts/config/profiles.py +16 -1
- package/scripts/context_hygiene_hook.py +2 -2
- package/scripts/council_cli.py +22 -22
- package/scripts/council_prune.py +3 -3
- package/scripts/discovery_stats.py +70 -0
- package/scripts/expected_perms.json +47 -0
- package/scripts/extract_audit_patterns.py +2 -2
- package/scripts/gen_discovery_baseline.py +127 -0
- package/scripts/generate_index.py +78 -46
- package/scripts/generate_ownership_matrix.py +99 -44
- package/scripts/generate_pack_manifests.py +183 -0
- package/scripts/hook_manifest.yaml +5 -5
- package/scripts/hooks/cline-dispatcher.sh +1 -1
- package/scripts/hooks/cowork-dispatcher.sh +1 -1
- package/scripts/hooks/dispatch_hook.py +3 -3
- package/scripts/hooks/gemini-dispatcher.sh +1 -1
- package/scripts/hooks/replay_hook.py +1 -1
- package/scripts/hooks/state_io.py +5 -5
- package/scripts/hooks_doctor.py +4 -4
- package/scripts/install +18 -1
- package/scripts/install-hooks.sh +2 -2
- package/scripts/install.py +937 -62
- package/scripts/install.sh +147 -27
- package/scripts/inventory_frontmatter.py +1 -1
- package/scripts/lint_agents_layout.py +183 -0
- package/scripts/lint_agents_md.py +1 -1
- package/scripts/lint_archived_skills.py +35 -19
- package/scripts/lint_artefact_frontmatter.py +180 -0
- package/scripts/lint_bench_corpus.py +14 -2
- package/scripts/lint_command_tiers.py +15 -2
- package/scripts/lint_discovery_manifest.py +136 -0
- package/scripts/lint_discovery_vocabulary.py +148 -0
- package/scripts/lint_explain_trace.py +80 -0
- package/scripts/lint_featured_skills.py +139 -0
- package/scripts/lint_framework_leakage.py +33 -6
- package/scripts/lint_framework_leakage_allowlist.json +63 -62
- package/scripts/lint_ghostwriter_source.py +1 -1
- package/scripts/lint_global_paths.py +147 -0
- package/scripts/lint_load_context.py +3 -3
- package/scripts/lint_mcp_registry_manifest.py +69 -0
- package/scripts/lint_media_policy_linkage.py +6 -6
- package/scripts/lint_orchestration_dsl.py +6 -3
- package/scripts/lint_pack_boundaries.py +147 -0
- package/scripts/lint_pack_first_win.py +103 -0
- package/scripts/lint_positioning.py +143 -0
- package/scripts/lint_readme_jargon.py +131 -0
- package/scripts/lint_readme_size.py +33 -0
- package/scripts/lint_rule_interactions.py +23 -5
- package/scripts/lint_rule_tiers.py +14 -5
- package/scripts/lint_skill_tools.py +1 -1
- package/scripts/lint_topics_yaml.py +89 -0
- package/scripts/lint_trust_coherence.py +212 -0
- package/scripts/mcp_server/consumer_tool_catalog.json +3 -3
- package/scripts/mcp_server/telemetry.py +2 -2
- package/scripts/mcp_server/tools.py +27 -11
- package/scripts/mcp_telemetry_health.py +2 -2
- package/scripts/mcp_telemetry_store.py +1 -1
- package/scripts/measure_augment_budget.py +3 -3
- package/scripts/measure_density.py +2 -2
- package/scripts/measure_frugality_savings.py +3 -3
- package/scripts/measure_roadmap_trajectory.py +1 -1
- package/scripts/measure_rule_budget.py +25 -7
- package/scripts/memory_report.py +1 -1
- package/scripts/migrate_command_suggestions.py +3 -3
- package/scripts/minimal_safe_diff_hook.py +1 -1
- package/scripts/move_artefact.py +143 -0
- package/scripts/new_skill.py +148 -0
- package/scripts/onboarding_gate_hook.py +4 -4
- package/scripts/plan_physical_move.py +353 -0
- package/scripts/prepack-check.mjs +62 -0
- package/scripts/probe_projection_fidelity.py +2 -2
- package/scripts/refine_ticket_detect.py +31 -8
- package/scripts/schemas/command.schema.json +45 -1
- package/scripts/schemas/persona.schema.json +1 -1
- package/scripts/schemas/rule.schema.json +44 -4
- package/scripts/schemas/skill.schema.json +41 -1
- package/scripts/score_skill_selection.py +1 -1
- package/scripts/skill_collision_clusters.py +1 -1
- package/scripts/skill_linter.py +250 -120
- package/scripts/skill_overlap.py +1 -1
- package/scripts/skill_tools/run_block_d_eval.py +1 -1
- package/scripts/skill_trigger_eval.py +28 -8
- package/scripts/skill_usage_collect.py +3 -3
- package/scripts/skill_usage_report.py +3 -3
- package/scripts/smoke/kernel.sh +1 -1
- package/scripts/smoke/router.sh +24 -5
- package/scripts/smoke/skills.sh +15 -7
- package/scripts/smoke_quickstart.py +12 -3
- package/scripts/snapshot_agent_outputs.py +144 -0
- package/scripts/spotcheck_thin_root.py +1 -1
- package/scripts/sync_github_metadata.py +147 -0
- package/scripts/sync_gitignore.py +15 -5
- package/scripts/update_counts.py +45 -17
- package/scripts/update_prices.py +4 -3
- package/scripts/validate_decision_engine.py +9 -1
- package/scripts/validate_discovery_manifest.py +94 -0
- package/scripts/validate_frontmatter.py +39 -20
- package/scripts/verify_before_complete_hook.py +1 -1
- package/scripts/verify_physical_move.py +185 -0
- package/scripts/verify_roadmap_closure.py +1 -1
- package/templates/agent-user.md +34 -0
- package/templates/agent-user.yml +21 -0
- package/templates/minimal/agents-overrides-readme.md +46 -0
- package/templates/minimal/overrides-gitkeep +2 -0
- package/.agent-src/commands/onboard.md +0 -467
- package/templates/minimal/agents-gitkeep +0 -2
|
@@ -7,6 +7,18 @@ execution:
|
|
|
7
7
|
type: assisted
|
|
8
8
|
handler: internal
|
|
9
9
|
allowed_tools: []
|
|
10
|
+
workspaces:
|
|
11
|
+
- agent-config-maintainer
|
|
12
|
+
packs:
|
|
13
|
+
- meta
|
|
14
|
+
lifecycle: active
|
|
15
|
+
trust:
|
|
16
|
+
level: core
|
|
17
|
+
confidence: high
|
|
18
|
+
human_review_required: false
|
|
19
|
+
install:
|
|
20
|
+
default: true
|
|
21
|
+
removable: false
|
|
10
22
|
---
|
|
11
23
|
|
|
12
24
|
# readme-reviewer
|
|
@@ -55,7 +67,7 @@ Inspect truth-defining files:
|
|
|
55
67
|
- Config files, tests, existing docs
|
|
56
68
|
|
|
57
69
|
Verify: install steps exist, commands work, features are implemented,
|
|
58
|
-
|
|
70
|
+
dependencies are real.
|
|
59
71
|
|
|
60
72
|
### 3. Validate installation and setup
|
|
61
73
|
|
|
@@ -141,8 +153,54 @@ Structure checks:
|
|
|
141
153
|
→ See `docs/guidelines/docs/readme-size-and-splitting.md` for full thresholds,
|
|
142
154
|
splitting strategies, and anti-patterns.
|
|
143
155
|
|
|
156
|
+
### 9. Validate every link and detect orphans — MANDATORY
|
|
157
|
+
|
|
158
|
+
For every internal link in the README:
|
|
159
|
+
|
|
160
|
+
1. Resolve the path. `test -f` files, `test -d` directories. Strip
|
|
161
|
+
`#anchor` and `?query` before the check.
|
|
162
|
+
2. For every anchor link (`file.md#section`), grep the target file for
|
|
163
|
+
the heading slug. Missing slug = broken anchor.
|
|
164
|
+
3. Group findings:
|
|
165
|
+
- **broken** — target does not exist (❌ Critical)
|
|
166
|
+
- **anchor-broken** — file exists, anchor does not (⚠️ Major)
|
|
167
|
+
- **path-drift** — target moved but a valid path exists elsewhere
|
|
168
|
+
(⚠️ Major, propose the corrected path)
|
|
169
|
+
|
|
170
|
+
For every documentation file referenced by the README, check whether
|
|
171
|
+
it has any **other** references in the repo (`grep -r` over
|
|
172
|
+
`AGENTS.md`, `docs/`, `.agent-src*/`, `.augment/`, `packages/`).
|
|
173
|
+
Files referenced only by this README are **single-use** — note them
|
|
174
|
+
so they can be moved or inlined later.
|
|
175
|
+
|
|
176
|
+
For every doc under `/docs/` that the README **does not** link, check
|
|
177
|
+
whether anything else in the repo links it. Files with zero inbound
|
|
178
|
+
references are **orphan-candidates** — surface them, never delete
|
|
179
|
+
silently.
|
|
180
|
+
|
|
181
|
+
### 10. Currency check — drift detection
|
|
182
|
+
|
|
183
|
+
The README may have been correct at write-time but drifted since.
|
|
184
|
+
Compare the README's claims to the live repository:
|
|
185
|
+
|
|
186
|
+
- **Counts** (badges like "Skills: 218") — recount from the source tree
|
|
187
|
+
and flag any drift > 0
|
|
188
|
+
- **Commands** — every documented `task`, `npm run`, `npx`, or `bash`
|
|
189
|
+
call must exist in `Taskfile.yml`, `package.json scripts`, or the
|
|
190
|
+
named script file at its claimed path
|
|
191
|
+
- **Profiles / user-types / packs** — list members against the live
|
|
192
|
+
directory listing
|
|
193
|
+
- **Version pins** — runtime, framework, peer-dep versions stated in
|
|
194
|
+
README vs. the manifest's `engines` / `require` / `dependencies`
|
|
195
|
+
- **Visual identity** — banner / hero image references resolve to real
|
|
196
|
+
files (not 404s in GitHub rendering)
|
|
197
|
+
|
|
144
198
|
## Output format
|
|
145
199
|
|
|
200
|
+
1. Produce three subsections in order: Summary, Findings, Confidence; no prose outside them.
|
|
201
|
+
2. Findings table must use the severity vocabulary (❌ Critical / ⚠️ Major / ℹ️ Minor) and cite the exact section name.
|
|
202
|
+
3. Close the report with a *Confidence* block that separates confirmed-correct, needs-verification, and unclear-due-to-missing-context.
|
|
203
|
+
|
|
146
204
|
### 1. Summary
|
|
147
205
|
|
|
148
206
|
| Field | Value |
|
|
@@ -156,8 +214,11 @@ splitting strategies, and anti-patterns.
|
|
|
156
214
|
| # | Severity | Section | Issue | Fix |
|
|
157
215
|
|---|---|---|---|---|
|
|
158
216
|
| 1 | ❌ Critical | Install | Command `X` does not exist | Replace with `Y` |
|
|
159
|
-
| 2 |
|
|
160
|
-
| 3 |
|
|
217
|
+
| 2 | ❌ Critical | Profile grid | Link `.agent-src.uncompressed/profiles/` 404s | Repoint to `packages/core/.agent-src.uncompressed/profiles/` |
|
|
218
|
+
| 3 | ⚠️ Major | Badges | "Skills: 218" — live count is 207 | Update badge or note drift |
|
|
219
|
+
| 4 | ⚠️ Major | Usage | Example uses deprecated API | Update to current API |
|
|
220
|
+
| 5 | ℹ️ Minor | Structure | Requirements buried below usage | Move above install |
|
|
221
|
+
| 6 | ℹ️ Minor | Docs | `docs/foo.md` only linked by README | Either inline or keep as standalone |
|
|
161
222
|
|
|
162
223
|
Severity levels:
|
|
163
224
|
|
|
@@ -7,6 +7,18 @@ execution:
|
|
|
7
7
|
type: assisted
|
|
8
8
|
handler: internal
|
|
9
9
|
allowed_tools: []
|
|
10
|
+
workspaces:
|
|
11
|
+
- agent-config-maintainer
|
|
12
|
+
packs:
|
|
13
|
+
- meta
|
|
14
|
+
lifecycle: active
|
|
15
|
+
trust:
|
|
16
|
+
level: core
|
|
17
|
+
confidence: high
|
|
18
|
+
human_review_required: false
|
|
19
|
+
install:
|
|
20
|
+
default: true
|
|
21
|
+
removable: false
|
|
10
22
|
---
|
|
11
23
|
|
|
12
24
|
# readme-writing
|
|
@@ -37,9 +49,34 @@ the intended audience. Reflects the real repository — not assumptions.
|
|
|
37
49
|
- **Strong quickstart over exhaustive noise** — a reader should get started in 30 seconds
|
|
38
50
|
- **Right scope** — high-level overview in README, deep content in dedicated docs
|
|
39
51
|
- **Match the repo type** — a package README differs from an app, CLI tool, or framework
|
|
52
|
+
- **Re-analyze every time** — never trust cached knowledge of the repo; the README that drifted yesterday is the README the model wrote from memory
|
|
53
|
+
- **Preserve existing visual identity** — banner, badges, profile/role grids, official logo lockups stay byte-identical unless the user explicitly asks to change them
|
|
40
54
|
|
|
41
55
|
## Procedure
|
|
42
56
|
|
|
57
|
+
### 0. Re-analysis gate — MANDATORY before any writing
|
|
58
|
+
|
|
59
|
+
Before drafting a single line, run a fresh repository inspection in **this**
|
|
60
|
+
session. Do not rely on prior knowledge, prior turns, or the existing README
|
|
61
|
+
prose. Produce an explicit evidence ledger:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
ledger:
|
|
65
|
+
package: <name + version from manifest>
|
|
66
|
+
description: <verbatim from manifest>
|
|
67
|
+
cli_entry: <bin / entry from manifest, if any>
|
|
68
|
+
commands: <list of real commands from Taskfile / Makefile / package.json scripts>
|
|
69
|
+
install: <verified install path(s) from scripts/install.* or docs>
|
|
70
|
+
doc_targets: <list of /docs files actually linked from the new draft>
|
|
71
|
+
counts: <skills / rules / commands / personas / advisors — if surfaced as badges>
|
|
72
|
+
visual_keep: <line range of existing README header, banner, badge block to preserve>
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
If any cell is unknown, run `ls`, `grep`, `find`, or read the file before
|
|
76
|
+
writing — never invent. If the user asks to "use the existing banner",
|
|
77
|
+
locate the exact source lines and reproduce them byte-for-byte, including
|
|
78
|
+
the surrounding HTML.
|
|
79
|
+
|
|
43
80
|
### 1. Identify README type and audience
|
|
44
81
|
|
|
45
82
|
Determine repository type:
|
|
@@ -127,26 +164,49 @@ for install, first example, or requirements).
|
|
|
127
164
|
splitting strategies (reference-split, deep-link tables, collapsibles),
|
|
128
165
|
multi-audience handling, and anti-patterns.
|
|
129
166
|
|
|
130
|
-
### 7. Validate
|
|
167
|
+
### 7. Validate links and detect orphans — MANDATORY
|
|
168
|
+
|
|
169
|
+
For every internal link in the new draft:
|
|
170
|
+
|
|
171
|
+
1. Resolve the path. If it points to a file, `test -f` the path. If a
|
|
172
|
+
directory, `test -d`. Strip `#anchor` and `?query` before the check.
|
|
173
|
+
2. For every anchor link (`file.md#section`), grep the target file for
|
|
174
|
+
the heading slug. Missing anchor = broken link.
|
|
175
|
+
3. Build the **link-delta** between the old README and the new one:
|
|
176
|
+
- **kept**: linked in both
|
|
177
|
+
- **added**: only linked by the new README
|
|
178
|
+
- **dropped**: only linked by the old README
|
|
179
|
+
|
|
180
|
+
For every `dropped` target, search the rest of the repository
|
|
181
|
+
(`grep -r "<path>"` over `AGENTS.md`, `docs/`, `.agent-src*/`,
|
|
182
|
+
`.augment/`, `packages/`). If no other file references it, mark
|
|
183
|
+
**orphan-candidate**. Surface the list to the user — do not delete
|
|
184
|
+
silently.
|
|
185
|
+
|
|
186
|
+
### 8. Validate
|
|
131
187
|
|
|
132
188
|
After writing, verify:
|
|
133
189
|
|
|
134
190
|
- [ ] Every documented command exists in the repo (`Taskfile.yml`, `Makefile`, `package.json scripts`, etc.)
|
|
135
191
|
- [ ] Setup steps are reproducible (no missing prerequisites)
|
|
136
192
|
- [ ] No features or capabilities are invented
|
|
137
|
-
- [ ] First screen
|
|
193
|
+
- [ ] **First screen contract** — within the first ~40 lines: project name, one-sentence pitch, install command (or pointer), and the primary CTA
|
|
194
|
+
- [ ] Banner, badges, and any explicit "preserve" block from Step 0 are byte-identical to source
|
|
138
195
|
- [ ] No dead sections (heading with 1-2 trivial sentences)
|
|
139
196
|
- [ ] Scope is right — deep content moved to dedicated docs, not crammed in
|
|
140
197
|
- [ ] Size below the "overloaded" threshold, or splitting is in place (see size guideline)
|
|
141
198
|
- [ ] ToC present if README > 150 lines or > 6 top-level sections
|
|
142
199
|
- [ ] Matches existing tonality if repo has established voice
|
|
143
|
-
- [ ]
|
|
200
|
+
- [ ] Every internal link resolved per Step 7 — zero broken file or anchor links
|
|
201
|
+
- [ ] Orphan-candidate list produced even if empty
|
|
144
202
|
|
|
145
203
|
## Output format
|
|
146
204
|
|
|
147
205
|
1. Full README draft
|
|
148
206
|
2. Short note: detected repo type + audience
|
|
149
|
-
3.
|
|
207
|
+
3. **Link delta** — `kept` / `added` / `dropped` with orphan-candidates flagged
|
|
208
|
+
4. Evidence ledger (Step 0) so the user can audit assumptions
|
|
209
|
+
5. Any uncertainties or assumptions that need confirmation
|
|
150
210
|
|
|
151
211
|
## Gotcha
|
|
152
212
|
|
|
@@ -7,6 +7,18 @@ execution:
|
|
|
7
7
|
type: assisted
|
|
8
8
|
handler: internal
|
|
9
9
|
allowed_tools: []
|
|
10
|
+
workspaces:
|
|
11
|
+
- agent-config-maintainer
|
|
12
|
+
packs:
|
|
13
|
+
- meta
|
|
14
|
+
lifecycle: active
|
|
15
|
+
trust:
|
|
16
|
+
level: core
|
|
17
|
+
confidence: high
|
|
18
|
+
human_review_required: false
|
|
19
|
+
install:
|
|
20
|
+
default: true
|
|
21
|
+
removable: false
|
|
10
22
|
---
|
|
11
23
|
|
|
12
24
|
# readme-writing-package
|
|
@@ -36,9 +48,33 @@ what it does, whether it fits their stack, how to install it, and how to use it.
|
|
|
36
48
|
- **Compatibility must be explicit** — don't imply broad support without evidence
|
|
37
49
|
- **First code example must be real, minimal, and verified** — no pseudo-code
|
|
38
50
|
- **README = onboarding, /docs = reference** — keep README focused
|
|
51
|
+
- **Re-analyze every time** — never write from cached knowledge; verify the manifest, source, and CI matrix in this session
|
|
52
|
+
- **Preserve existing visual identity** — banner, badges, hero images, and logo lockups stay byte-identical unless the user explicitly asks to change them
|
|
39
53
|
|
|
40
54
|
## Procedure
|
|
41
55
|
|
|
56
|
+
### 0. Re-analysis gate — MANDATORY before any writing
|
|
57
|
+
|
|
58
|
+
Before drafting, produce an evidence ledger from a fresh inspection of
|
|
59
|
+
the package — manifest, source, CI, examples. Do not rely on prior turns
|
|
60
|
+
or the existing README prose.
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
ledger:
|
|
64
|
+
package: <name + version from manifest>
|
|
65
|
+
description: <verbatim from manifest>
|
|
66
|
+
install_cmd: <verified against the manifest's package manager>
|
|
67
|
+
requirements: <language version, framework version, ext-*, services>
|
|
68
|
+
public_api: <entry classes / functions / exports from source>
|
|
69
|
+
test_command: <real command from manifest scripts / Taskfile>
|
|
70
|
+
doc_targets: <list of /docs files actually linked from the new draft>
|
|
71
|
+
visual_keep: <line range of existing README header / banner / badges to preserve>
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
If any cell is unknown, run `ls`, `grep`, `find`, or read the file before
|
|
75
|
+
writing — never invent. When the user asks to keep the existing banner
|
|
76
|
+
or badge row, reproduce it byte-for-byte from the source.
|
|
77
|
+
|
|
42
78
|
### 1. Identify package type and audience
|
|
43
79
|
|
|
44
80
|
| Type | Audience | README focus |
|
|
@@ -51,7 +87,7 @@ what it does, whether it fits their stack, how to install it, and how to use it.
|
|
|
51
87
|
|
|
52
88
|
### 2. Inspect package truth sources
|
|
53
89
|
|
|
54
|
-
Read files that define actual package behavior:
|
|
90
|
+
Read and **verify** files that define actual package behavior (confirm each claim against the source — never paraphrase from memory):
|
|
55
91
|
|
|
56
92
|
- Manifest: `composer.json`, `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, or `*.gemspec` — name, description, requirements, scripts
|
|
57
93
|
- Source entrypoints — public API surface, main classes/functions
|
|
@@ -243,7 +279,21 @@ capability comparison. They serve different jobs — install vs. coverage.
|
|
|
243
279
|
|
|
244
280
|
README = enough to adopt. Docs = enough to master.
|
|
245
281
|
|
|
246
|
-
### 8. Validate
|
|
282
|
+
### 8. Validate links and detect orphans — MANDATORY
|
|
283
|
+
|
|
284
|
+
For every internal link in the new draft:
|
|
285
|
+
|
|
286
|
+
1. Resolve the path. `test -f` files, `test -d` directories. Strip
|
|
287
|
+
`#anchor` and `?query` before the check.
|
|
288
|
+
2. For every anchor link, grep the target for the heading slug.
|
|
289
|
+
3. Build the **link-delta** vs. the old README — `kept` / `added` /
|
|
290
|
+
`dropped`. For every `dropped` target, search the rest of the repo
|
|
291
|
+
(`grep -r` over `AGENTS.md`, `docs/`, `.agent-src*/`, `packages/`).
|
|
292
|
+
No other reference → mark **orphan-candidate**.
|
|
293
|
+
|
|
294
|
+
Surface the orphan-candidate list to the user — never delete silently.
|
|
295
|
+
|
|
296
|
+
### 9. Validate
|
|
247
297
|
|
|
248
298
|
- [ ] Install command is correct and complete
|
|
249
299
|
- [ ] Compatibility/requirements match the manifest (`composer.json`, `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `*.gemspec`) and the CI matrix
|
|
@@ -254,15 +304,20 @@ README = enough to adopt. Docs = enough to master.
|
|
|
254
304
|
- [ ] Deep content is in docs, not README (see size guideline)
|
|
255
305
|
- [ ] Multi-platform install uses a table, not stacked blocks
|
|
256
306
|
- [ ] No duplication between README and `/docs/`
|
|
257
|
-
- [ ] First screen
|
|
307
|
+
- [ ] **First screen contract** — within ~40 lines: name, one-sentence pitch, install command, requirements (or pointer)
|
|
308
|
+
- [ ] Banner / badges / hero from Step 0 visual_keep are byte-identical to source
|
|
309
|
+
- [ ] Every internal link resolved per Step 8 — zero broken file or anchor links
|
|
310
|
+
- [ ] Orphan-candidate list produced even if empty
|
|
258
311
|
|
|
259
312
|
## Output format
|
|
260
313
|
|
|
261
314
|
1. Full README draft
|
|
262
315
|
2. Detected package type + audience
|
|
263
316
|
3. Compatibility summary
|
|
264
|
-
4.
|
|
265
|
-
5.
|
|
317
|
+
4. **Link delta** — `kept` / `added` / `dropped` with orphan-candidates flagged
|
|
318
|
+
5. Evidence ledger (Step 0) so the user can audit assumptions
|
|
319
|
+
6. Uncertainties needing confirmation
|
|
320
|
+
7. Suggested follow-up docs if README would become too large
|
|
266
321
|
|
|
267
322
|
## Gotcha
|
|
268
323
|
|
|
@@ -5,6 +5,18 @@ personas:
|
|
|
5
5
|
- critical-challenger
|
|
6
6
|
source: package
|
|
7
7
|
domain: process
|
|
8
|
+
workspaces:
|
|
9
|
+
- engineering
|
|
10
|
+
packs:
|
|
11
|
+
- engineering-base
|
|
12
|
+
lifecycle: active
|
|
13
|
+
trust:
|
|
14
|
+
level: core
|
|
15
|
+
confidence: high
|
|
16
|
+
human_review_required: false
|
|
17
|
+
install:
|
|
18
|
+
default: true
|
|
19
|
+
removable: false
|
|
8
20
|
---
|
|
9
21
|
|
|
10
22
|
# receiving-code-review
|
|
@@ -11,6 +11,18 @@ execution:
|
|
|
11
11
|
type: assisted
|
|
12
12
|
handler: internal
|
|
13
13
|
allowed_tools: []
|
|
14
|
+
workspaces:
|
|
15
|
+
- agent-config-maintainer
|
|
16
|
+
packs:
|
|
17
|
+
- meta
|
|
18
|
+
lifecycle: active
|
|
19
|
+
trust:
|
|
20
|
+
level: core
|
|
21
|
+
confidence: high
|
|
22
|
+
human_review_required: false
|
|
23
|
+
install:
|
|
24
|
+
default: true
|
|
25
|
+
removable: false
|
|
14
26
|
---
|
|
15
27
|
|
|
16
28
|
# Refine Prompt
|
|
@@ -284,4 +296,4 @@ For `low`, the question replaces the AC list:
|
|
|
284
296
|
- [`work_engine.scoring.confidence`](../../templates/scripts/work_engine/scoring/confidence.py) — rubric + band thresholds
|
|
285
297
|
- [`ask-when-uncertain`](../../rules/ask-when-uncertain.md) — one-question-per-turn Iron Law
|
|
286
298
|
- [`artifact-drafting-protocol`](../../rules/artifact-drafting-protocol.md) — this skill was drafted under it
|
|
287
|
-
- AI Council session: `agents/council
|
|
299
|
+
- AI Council session: `agents/runtime/council/responses/prompt-master-mini.json` (2026-05-17) — analysis behind the mini/max split and `/raw` bypass <!-- council-ref-allowed: ADR decision trace -->
|
|
@@ -14,6 +14,18 @@ execution:
|
|
|
14
14
|
type: assisted
|
|
15
15
|
handler: internal
|
|
16
16
|
allowed_tools: []
|
|
17
|
+
workspaces:
|
|
18
|
+
- product
|
|
19
|
+
packs:
|
|
20
|
+
- product-basic
|
|
21
|
+
lifecycle: active
|
|
22
|
+
trust:
|
|
23
|
+
level: professional
|
|
24
|
+
confidence: high
|
|
25
|
+
human_review_required: false
|
|
26
|
+
install:
|
|
27
|
+
default: true
|
|
28
|
+
removable: true
|
|
17
29
|
---
|
|
18
30
|
|
|
19
31
|
# Refine Ticket
|
|
@@ -151,7 +163,7 @@ in this skill folder) and returns:
|
|
|
151
163
|
- `threat-modeling` — fires on any auth / webhook / upload / queue /
|
|
152
164
|
secret / tenant / admin / PII / payment keyword, or a `CVE-YYYY-N`
|
|
153
165
|
regex match.
|
|
154
|
-
- `repo_aware` — on when `.git/`, `agents/contexts/`, `composer.json`,
|
|
166
|
+
- `repo_aware` — on when `.git/`, `agents/settings/contexts/`, `composer.json`,
|
|
155
167
|
or `package.json` is present in the cwd; off otherwise.
|
|
156
168
|
- When `repo_aware=True`, `decision.repo_context` is populated by
|
|
157
169
|
`gather_repo_context()`:
|
|
@@ -159,7 +171,7 @@ in this skill folder) and returns:
|
|
|
159
171
|
convention signal).
|
|
160
172
|
- `recent_commits` — up to 30 most recent commit subjects (active
|
|
161
173
|
modules + verb conventions).
|
|
162
|
-
- `context_docs` — every `agents/contexts/*.md` filename (domain
|
|
174
|
+
- `context_docs` — every `agents/settings/contexts/*.md` filename (domain
|
|
163
175
|
vocabulary).
|
|
164
176
|
- Outside a repo the context is empty — the skill produces the same
|
|
165
177
|
output shape, minus repo-specific citations (graceful degrade).
|
|
@@ -110,12 +110,12 @@ sub_skills:
|
|
|
110
110
|
repo_aware:
|
|
111
111
|
description: >
|
|
112
112
|
When invoked inside a repo clone, /refine-ticket loads
|
|
113
|
-
agents/contexts/ for domain vocabulary and scans recent branches /
|
|
113
|
+
agents/settings/contexts/ for domain vocabulary and scans recent branches /
|
|
114
114
|
commits for naming conventions. Outside a repo, skip silently.
|
|
115
115
|
signals:
|
|
116
116
|
- path: .git
|
|
117
117
|
type: dir
|
|
118
|
-
- path: agents/contexts
|
|
118
|
+
- path: agents/settings/contexts
|
|
119
119
|
type: dir
|
|
120
120
|
- path: composer.json
|
|
121
121
|
type: file
|
|
@@ -7,8 +7,18 @@ source: package
|
|
|
7
7
|
domain: product
|
|
8
8
|
context_spine: [product, team]
|
|
9
9
|
recommended_for_user_types: [creator, gtm, founder]
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
workspaces:
|
|
11
|
+
- gtm
|
|
12
|
+
packs:
|
|
13
|
+
- gtm-marketing
|
|
14
|
+
lifecycle: active
|
|
15
|
+
trust:
|
|
16
|
+
level: professional
|
|
17
|
+
confidence: high
|
|
18
|
+
human_review_required: false
|
|
19
|
+
install:
|
|
20
|
+
default: true
|
|
21
|
+
removable: true
|
|
12
22
|
---
|
|
13
23
|
|
|
14
24
|
# release-comms
|
|
@@ -3,6 +3,18 @@ name: repomix-packer
|
|
|
3
3
|
description: "Use when packaging a codebase to a single AI-friendly file for LLM analysis — local or remote, XML/Markdown/JSON, token counting, gitignore filtering, peer-side `repomix` CLI."
|
|
4
4
|
source: package
|
|
5
5
|
domain: process
|
|
6
|
+
workspaces:
|
|
7
|
+
- agent-config-maintainer
|
|
8
|
+
packs:
|
|
9
|
+
- meta
|
|
10
|
+
lifecycle: active
|
|
11
|
+
trust:
|
|
12
|
+
level: core
|
|
13
|
+
confidence: high
|
|
14
|
+
human_review_required: false
|
|
15
|
+
install:
|
|
16
|
+
default: true
|
|
17
|
+
removable: false
|
|
6
18
|
---
|
|
7
19
|
|
|
8
20
|
> **Pinned upstream:** `repomix` CLI (npm: `repomix`, brew: `repomix`). Re-verify per minor bump. Repomix is an **optional dependency** — this skill never installs it silently.
|
|
@@ -132,5 +144,5 @@ Cite the snapshot path so the consumer skill can read it.
|
|
|
132
144
|
|
|
133
145
|
- Upstream tool: https://github.com/yamadashy/repomix (MIT).
|
|
134
146
|
- Adopted from: `Microck/ordinary-claude-skills@8f5c83174f7aa683b4ddc7433150471983b93131:skills_all/repomix/SKILL.md` (MIT, © 2025 Microck) — wrapper-style adoption, no upstream code vendored.
|
|
135
|
-
- Provenance registry: `agents/contexts/skills-provenance.yml` (entry: `repomix`).
|
|
147
|
+
- Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `repomix`).
|
|
136
148
|
- Iron-Law floor: `non-destructive-by-default`, `missing-tool-handling`, `tool-safety`.
|
|
@@ -5,6 +5,18 @@ personas:
|
|
|
5
5
|
- critical-challenger
|
|
6
6
|
source: package
|
|
7
7
|
domain: process
|
|
8
|
+
workspaces:
|
|
9
|
+
- engineering
|
|
10
|
+
packs:
|
|
11
|
+
- engineering-base
|
|
12
|
+
lifecycle: active
|
|
13
|
+
trust:
|
|
14
|
+
level: core
|
|
15
|
+
confidence: high
|
|
16
|
+
human_review_required: false
|
|
17
|
+
install:
|
|
18
|
+
default: true
|
|
19
|
+
removable: false
|
|
8
20
|
---
|
|
9
21
|
|
|
10
22
|
# requesting-code-review
|
|
@@ -6,6 +6,18 @@ tier: senior
|
|
|
6
6
|
source: package
|
|
7
7
|
domain: product
|
|
8
8
|
context_spine: [product, customer-segment, funnel-stage]
|
|
9
|
+
workspaces:
|
|
10
|
+
- product
|
|
11
|
+
packs:
|
|
12
|
+
- product-basic
|
|
13
|
+
lifecycle: active
|
|
14
|
+
trust:
|
|
15
|
+
level: professional
|
|
16
|
+
confidence: high
|
|
17
|
+
human_review_required: false
|
|
18
|
+
install:
|
|
19
|
+
default: true
|
|
20
|
+
removable: true
|
|
9
21
|
---
|
|
10
22
|
|
|
11
23
|
# retention-loops
|
|
@@ -3,6 +3,18 @@ name: review-routing
|
|
|
3
3
|
description: "Use when preparing a PR description, suggesting reviewers, or flagging risk — produces owner-mapped roles plus historical bug-pattern matches from project-local YAML."
|
|
4
4
|
source: package
|
|
5
5
|
domain: quality
|
|
6
|
+
workspaces:
|
|
7
|
+
- agent-config-maintainer
|
|
8
|
+
packs:
|
|
9
|
+
- meta
|
|
10
|
+
lifecycle: active
|
|
11
|
+
trust:
|
|
12
|
+
level: core
|
|
13
|
+
confidence: high
|
|
14
|
+
human_review_required: false
|
|
15
|
+
install:
|
|
16
|
+
default: true
|
|
17
|
+
removable: false
|
|
6
18
|
---
|
|
7
19
|
|
|
8
20
|
# review-routing
|
|
@@ -5,6 +5,18 @@ status: active
|
|
|
5
5
|
tier: senior
|
|
6
6
|
source: package
|
|
7
7
|
domain: product
|
|
8
|
+
workspaces:
|
|
9
|
+
- product
|
|
10
|
+
packs:
|
|
11
|
+
- product-basic
|
|
12
|
+
lifecycle: active
|
|
13
|
+
trust:
|
|
14
|
+
level: professional
|
|
15
|
+
confidence: high
|
|
16
|
+
human_review_required: false
|
|
17
|
+
install:
|
|
18
|
+
default: true
|
|
19
|
+
removable: true
|
|
8
20
|
---
|
|
9
21
|
|
|
10
22
|
# rice-prioritization
|
|
@@ -6,6 +6,18 @@ personas:
|
|
|
6
6
|
- senior-engineer
|
|
7
7
|
source: package
|
|
8
8
|
domain: quality
|
|
9
|
+
workspaces:
|
|
10
|
+
- engineering
|
|
11
|
+
packs:
|
|
12
|
+
- engineering-base
|
|
13
|
+
lifecycle: active
|
|
14
|
+
trust:
|
|
15
|
+
level: core
|
|
16
|
+
confidence: high
|
|
17
|
+
human_review_required: false
|
|
18
|
+
install:
|
|
19
|
+
default: true
|
|
20
|
+
removable: false
|
|
9
21
|
---
|
|
10
22
|
|
|
11
23
|
# risk-officer
|
|
@@ -3,6 +3,18 @@ name: roadmap-management
|
|
|
3
3
|
description: "Use when the user says "create roadmap", "show roadmap", or "execute roadmap". Creates, reads, and manages roadmap files with phase tracking."
|
|
4
4
|
source: package
|
|
5
5
|
domain: process
|
|
6
|
+
workspaces:
|
|
7
|
+
- agent-config-maintainer
|
|
8
|
+
packs:
|
|
9
|
+
- meta
|
|
10
|
+
lifecycle: active
|
|
11
|
+
trust:
|
|
12
|
+
level: core
|
|
13
|
+
confidence: high
|
|
14
|
+
human_review_required: false
|
|
15
|
+
install:
|
|
16
|
+
default: true
|
|
17
|
+
removable: false
|
|
6
18
|
---
|
|
7
19
|
|
|
8
20
|
# roadmap-manager
|
|
@@ -3,6 +3,18 @@ name: roadmap-writing
|
|
|
3
3
|
description: "Use when authoring or rewriting a roadmap in agents/roadmaps/ — phase prose, goal sentence, acceptance criteria, council notes — even when the user just says 'write a plan for X' or 'draft a roadmap'."
|
|
4
4
|
source: package
|
|
5
5
|
domain: process
|
|
6
|
+
workspaces:
|
|
7
|
+
- agent-config-maintainer
|
|
8
|
+
packs:
|
|
9
|
+
- meta
|
|
10
|
+
lifecycle: active
|
|
11
|
+
trust:
|
|
12
|
+
level: core
|
|
13
|
+
confidence: high
|
|
14
|
+
human_review_required: false
|
|
15
|
+
install:
|
|
16
|
+
default: true
|
|
17
|
+
removable: false
|
|
6
18
|
---
|
|
7
19
|
|
|
8
20
|
<!-- cloud_safe: degrade -->
|
|
@@ -7,6 +7,18 @@ execution:
|
|
|
7
7
|
type: assisted
|
|
8
8
|
handler: shell
|
|
9
9
|
allowed_tools: []
|
|
10
|
+
workspaces:
|
|
11
|
+
- agent-config-maintainer
|
|
12
|
+
packs:
|
|
13
|
+
- meta
|
|
14
|
+
lifecycle: active
|
|
15
|
+
trust:
|
|
16
|
+
level: core
|
|
17
|
+
confidence: high
|
|
18
|
+
human_review_required: false
|
|
19
|
+
install:
|
|
20
|
+
default: true
|
|
21
|
+
removable: false
|
|
10
22
|
---
|
|
11
23
|
|
|
12
24
|
# rtk (Rust Token Killer)
|
|
@@ -3,6 +3,18 @@ name: rule-refactor
|
|
|
3
3
|
description: "Use when the rule set is over the Augment budget, when a new rule would breach it, or when asked to audit / merge / prune rules — runs the audit pipeline and proposes a verdict per rule."
|
|
4
4
|
source: package
|
|
5
5
|
domain: process
|
|
6
|
+
workspaces:
|
|
7
|
+
- agent-config-maintainer
|
|
8
|
+
packs:
|
|
9
|
+
- meta
|
|
10
|
+
lifecycle: active
|
|
11
|
+
trust:
|
|
12
|
+
level: core
|
|
13
|
+
confidence: high
|
|
14
|
+
human_review_required: false
|
|
15
|
+
install:
|
|
16
|
+
default: true
|
|
17
|
+
removable: false
|
|
6
18
|
---
|
|
7
19
|
|
|
8
20
|
<!-- cloud_safe: degrade -->
|
|
@@ -45,12 +57,12 @@ python3 scripts/measure_rule_budget.py --json > /tmp/rule-budget-before.json
|
|
|
45
57
|
The audit infrastructure already exists — compose it:
|
|
46
58
|
|
|
47
59
|
```bash
|
|
48
|
-
python3 scripts/audit_auto_rules.py # → agents/reports/auto-rules-audit.{json,md}
|
|
60
|
+
python3 scripts/audit_auto_rules.py # → agents/runtime/reports/auto-rules-audit.{json,md}
|
|
49
61
|
python3 scripts/audit_overlap.py # → appends overlap pairs to the MD
|
|
50
|
-
python3 scripts/audit_likelihood.py # → agents/reports/auto-rules-likelihood.json
|
|
62
|
+
python3 scripts/audit_likelihood.py # → agents/runtime/reports/auto-rules-likelihood.json
|
|
51
63
|
```
|
|
52
64
|
|
|
53
|
-
Then read `agents/reports/auto-rules-audit.md` end-to-end.
|
|
65
|
+
Then read `agents/runtime/reports/auto-rules-audit.md` end-to-end.
|
|
54
66
|
|
|
55
67
|
### 3. Categorise every flagged rule
|
|
56
68
|
|
|
@@ -3,6 +3,18 @@ name: rule-writing
|
|
|
3
3
|
description: "Use when creating or editing a rule in .agent-src.uncompressed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'."
|
|
4
4
|
source: package
|
|
5
5
|
domain: process
|
|
6
|
+
workspaces:
|
|
7
|
+
- agent-config-maintainer
|
|
8
|
+
packs:
|
|
9
|
+
- meta
|
|
10
|
+
lifecycle: active
|
|
11
|
+
trust:
|
|
12
|
+
level: core
|
|
13
|
+
confidence: high
|
|
14
|
+
human_review_required: false
|
|
15
|
+
install:
|
|
16
|
+
default: true
|
|
17
|
+
removable: false
|
|
6
18
|
---
|
|
7
19
|
|
|
8
20
|
<!-- cloud_safe: degrade -->
|
|
@@ -174,7 +186,7 @@ Forward-only: the new check applies to **the rule under review** and
|
|
|
174
186
|
to **future** edits. The baseline table is informational so reviewers
|
|
175
187
|
can distinguish genuine debt from acceptable carry-overs without
|
|
176
188
|
diffing the full lint output. See
|
|
177
|
-
`agents/analysis/lint-warning-triage.md` for the 3-bucket reference.
|
|
189
|
+
`agents/evidence/analysis/lint-warning-triage.md` for the 3-bucket reference.
|
|
178
190
|
|
|
179
191
|
## Frontmatter shape
|
|
180
192
|
|