@event4u/agent-config 6.0.0 → 6.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/.claude-plugin/marketplace.json +5 -5
- package/CHANGELOG.md +167 -440
- package/README.md +3 -3
- package/dist/agent-src/commands/agent-handoff.md +5 -4
- package/dist/agent-src/commands/agent-status.md +1 -0
- package/dist/agent-src/commands/agents/audit.md +1 -0
- package/dist/agent-src/commands/agents/init.md +3 -0
- package/dist/agent-src/commands/agents/optimize.md +1 -0
- package/dist/agent-src/commands/agents/user/accept.md +1 -0
- package/dist/agent-src/commands/agents/user/init.md +1 -0
- package/dist/agent-src/commands/agents/user/review.md +1 -0
- package/dist/agent-src/commands/agents/user/show.md +1 -0
- package/dist/agent-src/commands/agents/user/update.md +1 -0
- package/dist/agent-src/commands/agents/user.md +1 -0
- package/dist/agent-src/commands/agents.md +1 -0
- package/dist/agent-src/commands/analytics/prune.md +3 -2
- package/dist/agent-src/commands/analytics/show.md +3 -2
- package/dist/agent-src/commands/analytics.md +3 -2
- package/dist/agent-src/commands/analyze-reference-repo.md +1 -0
- package/dist/agent-src/commands/bug-fix.md +1 -0
- package/dist/agent-src/commands/bug-investigate.md +1 -0
- package/dist/agent-src/commands/challenge-me/vision.md +3 -2
- package/dist/agent-src/commands/challenge-me/with-docs.md +3 -2
- package/dist/agent-src/commands/challenge-me.md +3 -2
- package/dist/agent-src/commands/chat-history/import.md +9 -9
- package/dist/agent-src/commands/chat-history.md +32 -30
- package/dist/agent-src/commands/check-current-md.md +1 -0
- package/dist/agent-src/commands/commit/in-chunks.md +1 -0
- package/dist/agent-src/commands/commit.md +1 -0
- package/dist/agent-src/commands/condense.md +1 -0
- package/dist/agent-src/commands/context/create.md +1 -0
- package/dist/agent-src/commands/context/refactor.md +1 -0
- package/dist/agent-src/commands/context.md +1 -0
- package/dist/agent-src/commands/cost-report.md +5 -4
- package/dist/agent-src/commands/council/analysis.md +3 -2
- package/dist/agent-src/commands/council/debate.md +5 -4
- package/dist/agent-src/commands/council/default.md +3 -2
- package/dist/agent-src/commands/council/design.md +3 -2
- package/dist/agent-src/commands/council/optimize.md +3 -2
- package/dist/agent-src/commands/council/pr.md +3 -2
- package/dist/agent-src/commands/council.md +4 -3
- package/dist/agent-src/commands/e2e-heal.md +1 -0
- package/dist/agent-src/commands/e2e-plan.md +1 -0
- package/dist/agent-src/commands/estimate-ticket.md +1 -0
- package/dist/agent-src/commands/feature/dev.md +1 -0
- package/dist/agent-src/commands/feature/explore.md +1 -0
- package/dist/agent-src/commands/feature/plan.md +6 -6
- package/dist/agent-src/commands/feature/refactor.md +1 -0
- package/dist/agent-src/commands/feature/roadmap.md +1 -0
- package/dist/agent-src/commands/feature.md +1 -0
- package/dist/agent-src/commands/fix/ci.md +1 -0
- package/dist/agent-src/commands/fix/portability.md +1 -0
- package/dist/agent-src/commands/fix/pr-comments.md +147 -15
- package/dist/agent-src/commands/fix/refs.md +1 -0
- package/dist/agent-src/commands/fix/seeder.md +1 -0
- package/dist/agent-src/commands/fix.md +8 -8
- package/dist/agent-src/commands/ghostwriter/delete.md +1 -0
- package/dist/agent-src/commands/ghostwriter/fetch.md +1 -0
- package/dist/agent-src/commands/ghostwriter/list.md +1 -0
- package/dist/agent-src/commands/ghostwriter/show.md +1 -0
- package/dist/agent-src/commands/ghostwriter/write.md +1 -0
- package/dist/agent-src/commands/ghostwriter.md +1 -0
- package/dist/agent-src/commands/grill-me.md +3 -2
- package/dist/agent-src/commands/image/analyse.md +1 -0
- package/dist/agent-src/commands/image/create.md +1 -0
- package/dist/agent-src/commands/image/verify.md +1 -0
- package/dist/agent-src/commands/image.md +1 -0
- package/dist/agent-src/commands/implement-ticket.md +1 -0
- package/dist/agent-src/commands/jira-ticket.md +1 -0
- package/dist/agent-src/commands/judge/on-diff.md +1 -0
- package/dist/agent-src/commands/judge/solo.md +1 -0
- package/dist/agent-src/commands/judge/steps.md +1 -0
- package/dist/agent-src/commands/judge.md +1 -0
- package/dist/agent-src/commands/knowledge/cross-repo.md +1 -0
- package/dist/agent-src/commands/knowledge/forget.md +1 -0
- package/dist/agent-src/commands/knowledge/ingest.md +1 -0
- package/dist/agent-src/commands/knowledge/list.md +1 -0
- package/dist/agent-src/commands/knowledge.md +1 -0
- package/dist/agent-src/commands/memory/add.md +8 -6
- package/dist/agent-src/commands/memory/learn-low-impact.md +3 -2
- package/dist/agent-src/commands/memory/load.md +7 -7
- package/dist/agent-src/commands/memory/mine-session.md +39 -12
- package/dist/agent-src/commands/memory/promote.md +3 -2
- package/dist/agent-src/commands/memory/propose.md +7 -6
- package/dist/agent-src/commands/memory.md +3 -2
- package/dist/agent-src/commands/mode.md +1 -0
- package/dist/agent-src/commands/module/create.md +1 -0
- package/dist/agent-src/commands/module/explore.md +1 -0
- package/dist/agent-src/commands/module.md +1 -0
- package/dist/agent-src/commands/optimize/agents-dir.md +1 -0
- package/dist/agent-src/commands/optimize/augmentignore.md +1 -0
- package/dist/agent-src/commands/optimize/rtk.md +1 -0
- package/dist/agent-src/commands/optimize/skills.md +1 -0
- package/dist/agent-src/commands/optimize-prompt.md +1 -0
- package/dist/agent-src/commands/optimize.md +1 -0
- package/dist/agent-src/commands/orchestrate.md +1 -0
- package/dist/agent-src/commands/override/create.md +1 -0
- package/dist/agent-src/commands/override/manage.md +1 -0
- package/dist/agent-src/commands/override.md +1 -0
- package/dist/agent-src/commands/package-reset.md +1 -0
- package/dist/agent-src/commands/package-test.md +1 -0
- package/dist/agent-src/commands/post-as/ghostwriter.md +1 -0
- package/dist/agent-src/commands/post-as/me.md +1 -0
- package/dist/agent-src/commands/post-as.md +1 -0
- package/dist/agent-src/commands/pr/create/description-only.md +1 -0
- package/dist/agent-src/commands/pr/create.md +25 -0
- package/dist/agent-src/commands/prediction-pool.md +1 -0
- package/dist/agent-src/commands/prepare-for-review.md +1 -0
- package/dist/agent-src/commands/profile/activate.md +1 -0
- package/dist/agent-src/commands/profile/deactivate.md +1 -0
- package/dist/agent-src/commands/profile/show.md +1 -0
- package/dist/agent-src/commands/profile.md +1 -0
- package/dist/agent-src/commands/project-analyze.md +1 -0
- package/dist/agent-src/commands/project-health.md +1 -0
- package/dist/agent-src/commands/quality-fix.md +1 -0
- package/dist/agent-src/commands/refine-ticket.md +1 -0
- package/dist/agent-src/commands/research/deep.md +1 -0
- package/dist/agent-src/commands/research/report.md +1 -0
- package/dist/agent-src/commands/research.md +1 -0
- package/dist/agent-src/commands/review-changes.md +1 -0
- package/dist/agent-src/commands/review-routing.md +1 -0
- package/dist/agent-src/commands/roadmap/ai-council.md +1 -0
- package/dist/agent-src/commands/roadmap/create.md +1 -0
- package/dist/agent-src/commands/roadmap/process-full.md +1 -0
- package/dist/agent-src/commands/roadmap/process-phase.md +1 -0
- package/dist/agent-src/commands/roadmap/process-step.md +1 -0
- package/dist/agent-src/commands/roadmap.md +1 -0
- package/dist/agent-src/commands/rule-compliance-audit.md +1 -0
- package/dist/agent-src/commands/security-audit-config.md +84 -0
- package/dist/agent-src/commands/set-cost-profile.md +1 -0
- package/dist/agent-src/commands/skill/preview.md +1 -0
- package/dist/agent-src/commands/skill.md +1 -0
- package/dist/agent-src/commands/skills/discover.md +1 -0
- package/dist/agent-src/commands/skills.md +1 -0
- package/dist/agent-src/commands/sync-agent-settings.md +1 -0
- package/dist/agent-src/commands/sync-gitignore/fix.md +1 -0
- package/dist/agent-src/commands/sync-gitignore.md +1 -0
- package/dist/agent-src/commands/tests/create.md +1 -0
- package/dist/agent-src/commands/tests/execute.md +1 -0
- package/dist/agent-src/commands/tests.md +1 -0
- package/dist/agent-src/commands/threat-model.md +1 -0
- package/dist/agent-src/commands/update-form-request-messages.md +1 -0
- package/dist/agent-src/commands/upstream-contribute.md +1 -0
- package/dist/agent-src/commands/video/from-script.md +1 -0
- package/dist/agent-src/commands/video/from-song.md +1 -0
- package/dist/agent-src/commands/video/scene.md +1 -0
- package/dist/agent-src/commands/video/stitch.md +1 -0
- package/dist/agent-src/commands/video/storyboard.md +1 -0
- package/dist/agent-src/commands/video.md +1 -0
- package/dist/agent-src/commands/work.md +1 -0
- package/dist/agent-src/contexts/augment-infrastructure.md +1 -1
- package/dist/agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +1 -1
- package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +2 -2
- package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +6 -6
- package/dist/agent-src/contexts/contracts/consumer-agents-md-guide.md +2 -2
- package/dist/agent-src/contexts/execution/rdp-gate.md +75 -0
- package/dist/agent-src/contexts/subagent-configuration.md +1 -0
- package/dist/agent-src/personas/advisors/contrarian.md +1 -1
- package/dist/agent-src/personas/advisors/executor.md +1 -1
- package/dist/agent-src/personas/advisors/expansionist.md +1 -1
- package/dist/agent-src/personas/advisors/first-principles.md +1 -1
- package/dist/agent-src/personas/advisors/outsider.md +1 -1
- package/dist/agent-src/rules/autonomous-execution.md +12 -0
- package/dist/agent-src/rules/external-reference-deep-dive.md +1 -1
- package/dist/agent-src/rules/git-history-discipline.md +47 -1
- package/dist/agent-src/rules/improve-before-implement.md +12 -0
- package/dist/agent-src/rules/lethal-trifecta-guard.md +80 -0
- package/dist/agent-src/rules/no-pr-progress-comments.md +3 -4
- package/dist/agent-src/rules/notes-first-reasoning.md +71 -0
- package/dist/agent-src/rules/roadmap-progress-sync.md +48 -31
- package/dist/agent-src/rules/security-sensitive-stop.md +14 -1
- package/dist/agent-src/rules/source-confidentiality.md +97 -0
- package/dist/agent-src/rules/think-before-action.md +9 -1
- package/dist/agent-src/rules/untrusted-input-defense.md +76 -0
- package/dist/agent-src/scripts/archive_completed_roadmaps.py +171 -0
- package/dist/agent-src/skills/adversarial-review/SKILL.md +14 -0
- package/dist/agent-src/skills/agent-security-review/SKILL.md +113 -0
- package/dist/agent-src/skills/agent-security-review/evals/triggers.json +51 -0
- package/dist/agent-src/skills/ai-council/SKILL.md +3 -3
- package/dist/agent-src/skills/async-python-patterns/SKILL.md +1 -1
- package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +12 -11
- package/dist/agent-src/skills/command-routing/SKILL.md +1 -1
- package/dist/agent-src/skills/complexity-first-planning/SKILL.md +96 -0
- package/dist/agent-src/skills/complexity-first-planning/evals/triggers.json +16 -0
- package/dist/agent-src/skills/copilot-config/SKILL.md +3 -4
- package/dist/agent-src/skills/defense-in-depth/SKILL.md +1 -1
- package/dist/agent-src/skills/developer-like-execution/SKILL.md +5 -4
- package/dist/agent-src/skills/error-handling-patterns/SKILL.md +1 -1
- package/dist/agent-src/skills/feature-planning/SKILL.md +2 -2
- package/dist/agent-src/skills/mcp-builder/SKILL.md +1 -1
- package/dist/agent-src/skills/memory-consolidation/SKILL.md +63 -17
- package/dist/agent-src/skills/prompt-engineering-patterns/SKILL.md +1 -1
- package/dist/agent-src/skills/readme-writing-package/SKILL.md +1 -1
- package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +119 -0
- package/dist/agent-src/skills/reasoning-orchestrator/evals/triggers.json +16 -0
- package/dist/agent-src/skills/receiving-code-review/SKILL.md +6 -6
- package/dist/agent-src/skills/refine-prompt/SKILL.md +1 -1
- package/dist/agent-src/skills/refine-ticket/SKILL.md +1 -1
- package/dist/agent-src/skills/repomix-packer/SKILL.md +1 -1
- package/dist/agent-src/skills/secrets-management/SKILL.md +1 -1
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +10 -3
- package/dist/agent-src/skills/testing-anti-patterns/SKILL.md +1 -1
- package/dist/agent-src/skills/testing-anti-patterns/process-anti-patterns.md +1 -1
- package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
- package/dist/agent-src/templates/agents/.gitattributes.fragment +0 -1
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +4 -4
- package/dist/agent-src/templates/scripts/check_memory.py +1 -2
- package/dist/agent-src/templates/scripts/check_memory_proposal.py +1 -1
- package/dist/agent-src/templates/scripts/memory_lookup.py +148 -289
- package/dist/agent-src/templates/scripts/memory_report.py +132 -2
- package/dist/agent-src/templates/scripts/memory_signal.py +7 -9
- package/dist/agent-src/templates/scripts/memory_status.py +25 -206
- package/dist/agent-src/templates/scripts/work_engine/directives/backend/memory.py +6 -6
- package/dist/agent-src/templates/scripts/work_engine/directives/ui/_passthrough.py +3 -3
- package/dist/agent-src/templates/scripts/work_engine/scoring/memory_visibility.py +0 -1
- package/dist/cli/agent-config.js +31 -300
- package/dist/cli/agent-config.js.map +1 -1
- package/dist/cli/commands/commands.js +10 -5
- package/dist/cli/commands/commands.js.map +1 -1
- package/dist/cli/discovery/loadManifest.js.map +1 -1
- package/dist/cli/main.js +309 -0
- package/dist/cli/main.js.map +1 -0
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +645 -342
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +8 -5
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +149 -37
- package/dist/discovery/trust-report.md +3 -3
- package/dist/discovery/workspaces.json +61 -36
- package/dist/mcp/registry-manifest.json +4 -4
- package/dist/router.json +1 -1
- package/dist/server/routes/wizard.js +4 -3
- package/dist/server/routes/wizard.js.map +1 -1
- package/dist/server/schemas/settings.js +18 -0
- package/dist/server/schemas/settings.js.map +1 -1
- package/docs/MIGRATION.md +1 -1
- package/docs/adrs/cost/0001-hard-stop-hook.md +5 -5
- package/docs/adrs/memory/0001-consumer-side-snapshot.md +15 -7
- package/docs/adrs/memory/README.md +6 -5
- package/docs/adrs/router/0001-three-tier-routing.md +2 -2
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +2 -2
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +5 -5
- package/docs/adrs/telegraph/0001-default-off-until-bench.md +3 -3
- package/docs/architecture.md +9 -9
- package/docs/archive/CHANGELOG-pre-2.2.0.md +30 -30
- package/docs/archive/CHANGELOG-pre-2.25.0.md +1 -1
- package/docs/archive/CHANGELOG-pre-4.5.0.md +1 -1
- package/docs/archive/CHANGELOG-pre-6.0.0.md +473 -0
- package/docs/benchmark.md +54 -53
- package/docs/benchmarks.md +2 -2
- package/docs/case-studies/{frontend-design-vs-ui-ux-pro-max.md → frontend-design-positioning.md} +4 -4
- package/docs/catalog.md +20 -13
- package/docs/command-flows.md +90 -92
- package/docs/contracts/adr-layout.md +2 -3
- package/docs/contracts/adr-level-6-productization.md +1 -1
- package/docs/contracts/ai-council-config.md +42 -7
- package/docs/contracts/command-clusters.md +1 -1
- package/docs/contracts/cost-enforcement.md +1 -1
- package/docs/contracts/cost-summary-schema.md +1 -1
- package/docs/contracts/daily-workspace.md +1 -0
- package/docs/contracts/discovery-manifest.schema.json +4 -2
- package/docs/contracts/explain-modes.md +1 -1
- package/docs/contracts/implement-ticket-flow.md +6 -7
- package/docs/contracts/mcp-tool-inventory.md +10 -10
- package/docs/contracts/measurement-baseline.md +1 -1
- package/docs/contracts/memory-visibility-v1.md +1 -5
- package/docs/contracts/namespace.md +1 -1
- package/docs/contracts/persona-schema.md +1 -1
- package/docs/contracts/rule-interactions.md +1 -1
- package/docs/contracts/smoke-contracts.md +1 -1
- package/docs/contracts/universal-skills.md +0 -1
- package/docs/contracts/workspace-boundary.md +84 -0
- package/docs/customization.md +3 -3
- package/docs/decisions/ADR-009-event4u-namespace.md +1 -1
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +1 -1
- package/docs/decisions/ADR-026-explain-mode-translation.md +1 -1
- package/docs/decisions/ADR-088-no-external-runtime-federation.md +26 -27
- package/docs/decisions/ADR-090-visibility-command-frontmatter-field.md +95 -0
- package/docs/decisions/ADR-091-split-meta-capability-packs.md +113 -0
- package/docs/decisions/ADR-092-defer-command-tier-alias-removal.md +93 -0
- package/docs/decisions/ADR-093-ai-council-config-user-global.md +111 -0
- package/docs/decisions/ADR-094-agent-memory-layer-removal.md +94 -0
- package/docs/decisions/ADR-095-workspace-boundary-contract.md +108 -0
- package/docs/decisions/INDEX.md +6 -0
- package/docs/development.md +5 -7
- package/docs/getting-started.md +4 -4
- package/docs/guidelines/agent-infra/5w2h-analysis.md +1 -1
- package/docs/guidelines/agent-infra/comparison-matrix.md +1 -1
- package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
- package/docs/guidelines/agent-infra/critical-thinking.md +1 -1
- package/docs/guidelines/agent-infra/engineering-memory-data-format.md +1 -5
- package/docs/guidelines/agent-infra/first-principles.md +1 -1
- package/docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md +164 -0
- package/docs/guidelines/agent-infra/inversion-thinking.md +1 -1
- package/docs/guidelines/agent-infra/ios-simulator-guide.md +9 -14
- package/docs/guidelines/agent-infra/mcp-request-signing.md +19 -22
- package/docs/guidelines/agent-infra/memory-access.md +25 -31
- package/docs/guidelines/agent-infra/mental-models.md +1 -1
- package/docs/guidelines/agent-infra/model-recommendation.md +29 -0
- package/docs/guidelines/agent-infra/scqa-framework.md +3 -3
- package/docs/guidelines/agent-infra/security-lint-containment.md +81 -0
- package/docs/guidelines/agent-infra/six-hats.md +1 -1
- package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
- package/docs/guidelines/agent-infra/untrusted-input-spotlighting.md +72 -0
- package/docs/installation.md +1 -1
- package/docs/mcp.md +2 -2
- package/docs/parity/{bench-ruflo.json → bench-external.json} +10 -10
- package/docs/parity/{ruflo.md → external-runtime.md} +9 -9
- package/docs/quality.md +3 -3
- package/docs/safety.md +3 -3
- package/docs/skills-catalog.md +4 -1
- package/llms.txt +3 -0
- package/package.json +1 -1
- package/src/config/agent-settings.template.yml +65 -3
- package/src/config/discovery/packs.yml +29 -0
- package/src/config/discovery/workspaces.yml +3 -1
- package/src/config/gitignore-block.txt +6 -0
- package/src/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
- package/src/scripts/_cli/cmd_doctor.py +99 -13
- package/src/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
- package/src/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
- package/src/scripts/_lib/bench_ab_scoring_v2.py +227 -0
- package/src/scripts/_lib/global_deploy_inventory.py +39 -9
- package/src/scripts/_lib/link_crypto.py +206 -0
- package/src/scripts/_lib/security_lint.py +228 -0
- package/src/scripts/ai_council/clients.py +2 -2
- package/src/scripts/ai_council/config.py +55 -0
- package/src/scripts/audit_adr_coverage.py +0 -2
- package/src/scripts/audit_command_surface.py +18 -5
- package/src/scripts/audit_mcp_tools.py +2 -2
- package/src/scripts/audit_skill_descriptions.py +2 -2
- package/src/scripts/bench_ab_clone.py +62 -12
- package/src/scripts/bench_ab_task_runner.py +475 -30
- package/src/scripts/bench_ab_v2_run.py +247 -0
- package/src/scripts/bench_ab_v2_stats.py +347 -0
- package/src/scripts/bench_run.py +1 -1
- package/src/scripts/build_discovery_manifest.py +10 -0
- package/src/scripts/check_bite_sized_granularity.py +1 -2
- package/src/scripts/check_memory.py +49 -63
- package/src/scripts/check_memory_proposal.py +1 -1
- package/src/scripts/check_no_external_sources.py +101 -0
- package/src/scripts/check_references.py +2 -0
- package/src/scripts/cost_by_conversation.py +1 -1
- package/src/scripts/council_cli.py +28 -14
- package/src/scripts/external_sources_denylist.json +91 -0
- package/src/scripts/hook_manifest.yaml +14 -6
- package/src/scripts/injection_scan_hook.py +145 -0
- package/src/scripts/install-hooks.sh +11 -0
- package/src/scripts/install.py +88 -13
- package/src/scripts/lint_agent_security.py +112 -0
- package/src/scripts/lint_bench_ab.py +5 -4
- package/src/scripts/lint_command_tiers.py +63 -22
- package/src/scripts/lint_discovery_vocabulary.py +2 -0
- package/src/scripts/lint_empty_roadmaps.py +80 -0
- package/src/scripts/lint_hidden_unicode.py +132 -0
- package/src/scripts/lint_instruction_smuggling.py +107 -0
- package/src/scripts/lint_marketplace.py +1 -1
- package/src/scripts/lint_mcp_config_security.py +124 -0
- package/src/scripts/lint_skill_frontmatter_safety.py +144 -0
- package/src/scripts/lint_workspace_boundary.py +122 -0
- package/src/scripts/mcp_server/consumer_tool_catalog.json +2 -3
- package/src/scripts/mcp_server/tools.py +8 -32
- package/src/scripts/memory_lookup.py +27 -296
- package/src/scripts/memory_report.py +1 -23
- package/src/scripts/memory_signal.py +6 -53
- package/src/scripts/memory_status.py +25 -206
- package/src/scripts/mine_session.py +118 -41
- package/src/scripts/pack_dependency_allowlist.json +2 -2
- package/src/scripts/render_benchmark_md.py +141 -52
- package/src/scripts/schemas/command.schema.json +6 -1
- package/src/scripts/security_audit_config.py +153 -0
- package/dist/agent-src/commands/chat-history/learn.md +0 -184
- package/dist/agent-src/commands/chat-history/show.md +0 -113
- package/dist/agent-src/commands/fix/pr-bot-comments.md +0 -157
- package/dist/agent-src/commands/fix/pr-developer-comments.md +0 -163
- package/dist/agent-src/templates/agents/memory/architecture-decisions.example.yml +0 -95
- package/docs/contracts/agent-memory-contract.md +0 -159
|
@@ -167,7 +167,7 @@ complexity: lightweight # default — skips bite-sized granularity
|
|
|
167
167
|
---
|
|
168
168
|
```
|
|
169
169
|
|
|
170
|
-
Source: adapted from
|
|
170
|
+
Source: adapted from an external reference `writing-plans/SKILL.md` § Task Structure + § No Placeholders (v5.1.0); complexity-gating is our addition (Council Round 1, Q4 — mitigates UX pushback for senior engineers on well-scoped work).
|
|
171
171
|
|
|
172
172
|
## Self-review (3-scan checklist)
|
|
173
173
|
|
|
@@ -179,7 +179,7 @@ Before presenting any plan, run these three scans in order. Each is a fast pass
|
|
|
179
179
|
|
|
180
180
|
This scan is **separate from** adversarial-review (below). Self-review catches mechanical gaps (missing AC, leftover placeholders, mis-shaped types); adversarial-review challenges the plan's reasoning.
|
|
181
181
|
|
|
182
|
-
Source: adapted from
|
|
182
|
+
Source: adapted from an external reference `writing-plans/SKILL.md` § Self-Review (v5.1.0).
|
|
183
183
|
|
|
184
184
|
## Adversarial self-review
|
|
185
185
|
|
|
@@ -107,7 +107,7 @@ Process: enumerate the tools, explore READ-ONLY data, draft 10 questions, **solv
|
|
|
107
107
|
|
|
108
108
|
- Upstream protocol: https://modelcontextprotocol.io
|
|
109
109
|
- Upstream SDKs: https://github.com/modelcontextprotocol/python-sdk · https://github.com/modelcontextprotocol/typescript-sdk
|
|
110
|
-
- Adopted from:
|
|
110
|
+
- Adopted from: an external reference (MIT, © 2025 an external reference) — external `./reference/*.md` file links replaced with inline guidance + upstream URLs.
|
|
111
111
|
- Cross-linked: [`mcp`](../mcp/SKILL.md), [`testing-anti-patterns`](../testing-anti-patterns/SKILL.md), [`api-design`](../api-design/SKILL.md).
|
|
112
112
|
- Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `mcp-builder`).
|
|
113
113
|
- Iron-Law floor: `verify-before-complete`, `tool-safety`, `skill-quality`.
|
|
@@ -90,13 +90,15 @@ miner is too loose; tighten patterns and re-run before promoting.
|
|
|
90
90
|
|
|
91
91
|
A fact may carry **two** tags; the promoter resolves via tag
|
|
92
92
|
intersection, not by file extension. See
|
|
93
|
-
[`
|
|
94
|
-
for the curated YAML
|
|
93
|
+
[`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md)
|
|
94
|
+
for the file-backed retrieval contract over the curated YAML.
|
|
95
95
|
|
|
96
96
|
2. Append each fact as one JSONL line to
|
|
97
97
|
`agents/memory/intake/<primary-tag>.jsonl` with required fields
|
|
98
98
|
per the contract: `ts`, `type`, `key`, `observation`, `source:
|
|
99
99
|
agent`, `session_id`, plus the new optional `tags: [<one>, <two>]`.
|
|
100
|
+
Intake is **gitignored, local scratch** — only entries promoted to
|
|
101
|
+
curated YAML (next phase) become team-shared (committed).
|
|
100
102
|
3. Default to `--preview` mode: render the JSONL block to stdout and
|
|
101
103
|
stop. Only `--commit-intake` writes the file.
|
|
102
104
|
|
|
@@ -109,13 +111,45 @@ validates against the contract.
|
|
|
109
111
|
archive the consumed JSONL lines into
|
|
110
112
|
`agents/memory/intake/.archive/YYYY-Www.jsonl` — week-bucketed,
|
|
111
113
|
not day-bucketed (defeats session-context inference attacks).
|
|
112
|
-
2.
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
114
|
+
2. **Delete `status: archived` curated entries.** Once an entry is
|
|
115
|
+
marked `archived` (by review or supersession), remove it from the hot
|
|
116
|
+
file — **git history is the cold archive** (`git log -- <file>`
|
|
117
|
+
recovers it). This keeps the committed memory small without a decay
|
|
118
|
+
engine. Do not keep an `agents/memory/archive/` directory.
|
|
119
|
+
3. If an *active* curated entry's `last_validated` is older than 90 days
|
|
120
|
+
AND no signal in the last 30 days touched its `key`, mark it stale in
|
|
121
|
+
the consolidation report — but do **not** auto-delete a still-active
|
|
122
|
+
entry. Only `archived` entries are deleted; staleness is a flag, not a
|
|
123
|
+
delete trigger.
|
|
124
|
+
|
|
125
|
+
**Exit gate:** report cites ≥ 0 promotions, ≥ 0 stale flags, and the
|
|
126
|
+
count of `archived` entries deleted (git history retains them).
|
|
127
|
+
|
|
128
|
+
## Write-time curation discipline
|
|
129
|
+
|
|
130
|
+
Memory quality comes from what you write, not from a heavy store. Apply
|
|
131
|
+
these at GATHER + CONSOLIDATE (adapted from MemSkill's memory-operation
|
|
132
|
+
skills — github.com/ViktorAxelsen/MemSkill, Apache-2.0, commit `9907c35f8cc7`):
|
|
133
|
+
|
|
134
|
+
- **Dedupe before insert.** Compare against retrieved entries; never add a
|
|
135
|
+
fact already covered. Split distinct facts into separate entries.
|
|
136
|
+
- **Merge on refresh, preserve what still holds.** When a fact updates an
|
|
137
|
+
existing entry, merge into one item and keep the details that remain true.
|
|
138
|
+
- **Delete only on explicit contradiction.** Remove a curated entry only when
|
|
139
|
+
evidence directly contradicts or cancels it. If uncertain, keep it.
|
|
140
|
+
- **Prefer no-op under uncertainty.** A chunk with no new, corrective, or
|
|
141
|
+
actionable information records nothing — silence beats speculation.
|
|
142
|
+
- **Skip trivial / fleeting / speculative content.** Capture durable,
|
|
143
|
+
reusable facts, not transcripts or one-off chatter.
|
|
144
|
+
- **One durable fact per entry.** No narrative blobs — each entry is a single
|
|
145
|
+
PATTERN / CONVENTION / INVARIANT / GOTCHA the next agent can act on.
|
|
146
|
+
|
|
147
|
+
This is **meta-memory**: the skill of *how to remember* (what to extract,
|
|
148
|
+
keep, forget) — distinct from the remembered content. The store stays simple
|
|
149
|
+
and file-backed; the discipline lives here. Do **not** add
|
|
150
|
+
INSERT/UPDATE/DELETE/NOOP operation machinery (append-only JSONL + curated
|
|
151
|
+
YAML need no such ops) and do **not** import any retrieval / decay / trust
|
|
152
|
+
engine.
|
|
119
153
|
|
|
120
154
|
## TranscriptAdapter contract
|
|
121
155
|
|
|
@@ -134,11 +168,24 @@ The miner is host-agnostic by design. A `TranscriptAdapter` for host
|
|
|
134
168
|
identifier the consumer project lists in
|
|
135
169
|
`.agent-settings.yml` under `memory.redact_patterns`.
|
|
136
170
|
|
|
137
|
-
|
|
138
|
-
`/memory:mine-session` (
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
171
|
+
The GATHER implementation lives in the single mining command
|
|
172
|
+
`/memory:mine-session` (`scripts/mine_session.py`). It reads the
|
|
173
|
+
**cross-host** chat-history JSONL log (`agents/runtime/.agent-chat-history`,
|
|
174
|
+
written by platform hooks on every host), falling back to the per-host
|
|
175
|
+
Claude-Code transcript when the log is absent. `--mode=[signals|proposals|both]`
|
|
176
|
+
selects intake signals and/or rule/skill proposal seeds — the latter folds in
|
|
177
|
+
the former `/chat-history learn`.
|
|
178
|
+
|
|
179
|
+
## In-task notes → cross-run lessons (RDP)
|
|
180
|
+
|
|
181
|
+
The Reasoning Discipline Protocol writes an **in-task** session-notes file
|
|
182
|
+
(hypotheses, killed beliefs, predictions, decisions, uncertainty — structure in
|
|
183
|
+
[`notes-first-reasoning`](../../rules/notes-first-reasoning.md)). That file is
|
|
184
|
+
ephemeral working state, not curated memory. This skill is the **promotion path**:
|
|
185
|
+
when an in-task killed-belief, calibrated prediction, or decision *generalises*
|
|
186
|
+
beyond the task, consolidate it here as a durable cross-run lesson (one lesson per
|
|
187
|
+
file, with why it mattered). Apply the same signal-vs-noise discipline — most
|
|
188
|
+
in-task notes stay in-task and are discarded with the task.
|
|
142
189
|
|
|
143
190
|
## Related Skills
|
|
144
191
|
|
|
@@ -196,9 +243,8 @@ documented now so the second implementation is not a vacuum design.
|
|
|
196
243
|
|
|
197
244
|
- Do NOT auto-trigger this skill on session end. The flow is manual,
|
|
198
245
|
per-invocation, and confirmed.
|
|
199
|
-
- Do NOT vendor patterns or text from
|
|
200
|
-
|
|
201
|
-
the only adoption surface.
|
|
246
|
+
- Do NOT vendor patterns or text from any external source. Concept and
|
|
247
|
+
procedure structure are the only adoption surface.
|
|
202
248
|
- Do NOT promote a normalised fact whose `key` falls outside the
|
|
203
249
|
repo root or names another consumer project.
|
|
204
250
|
- Do NOT delete a stale curated entry without explicit user
|
|
@@ -144,7 +144,7 @@ Production prompts handle their own failure cases:
|
|
|
144
144
|
|
|
145
145
|
## Provenance
|
|
146
146
|
|
|
147
|
-
- Adopted from:
|
|
147
|
+
- Adopted from: an external reference (MIT, © 2025 an external reference) — restructured into a decision-framework shape; vendor `prompt_optimizer` Python snippets dropped (project-specific to an external reference).
|
|
148
148
|
- Cross-linked: [`prompt-optimizer`](../prompt-optimizer/SKILL.md), [`refine-prompt`](../refine-prompt/SKILL.md), [`mcp-builder`](../mcp-builder/SKILL.md), [`async-python-patterns`](../async-python-patterns/SKILL.md).
|
|
149
149
|
- Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `prompt-engineering-patterns`).
|
|
150
150
|
- Iron-Law floor: `verify-before-complete`, `skill-quality`, `non-destructive-by-default`.
|
|
@@ -263,7 +263,7 @@ Pair the catalog with a separate "Global install" subsection (same flags
|
|
|
263
263
|
plus `--global`) and an "Other commands" subsection. Reference example:
|
|
264
264
|
[`README.md § Pick specific AIs`](../../../README.md#pick-specific-ais) in
|
|
265
265
|
this repository. Inspiration:
|
|
266
|
-
[`
|
|
266
|
+
[`an external reference suite § Installation`](https://github.com/an external reference suite#installation).
|
|
267
267
|
|
|
268
268
|
Use the catalog when the package's primary install action varies by
|
|
269
269
|
platform; use a matrix table (Tool / Rules / Skills / Commands) for
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reasoning-orchestrator
|
|
3
|
+
description: "Use for complex / ambiguous / long-horizon work — coordinate the reasoning chain ground→intent→notes→gather→audit→verify; composes existing skills, never duplicates them."
|
|
4
|
+
source: package
|
|
5
|
+
domain: engineering
|
|
6
|
+
status: active
|
|
7
|
+
model_tier: medium
|
|
8
|
+
tier: senior
|
|
9
|
+
context_spine: [repo]
|
|
10
|
+
workspaces:
|
|
11
|
+
- agent-config-maintainer
|
|
12
|
+
packs:
|
|
13
|
+
- meta
|
|
14
|
+
requires_skills:
|
|
15
|
+
- memory-consolidation
|
|
16
|
+
- adversarial-review
|
|
17
|
+
- subagent-orchestration
|
|
18
|
+
- complexity-first-planning
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
# reasoning-orchestrator
|
|
22
|
+
|
|
23
|
+
The **primary coordination mechanism** of the Reasoning Discipline Protocol
|
|
24
|
+
(roadmap L6). It is behavioral glue — like [`subagent-orchestration`](../subagent-orchestration/SKILL.md)
|
|
25
|
+
and [`feature-planning`](../feature-planning/SKILL.md) — that sequences the
|
|
26
|
+
discipline so it acts as one system instead of a buffet of optional steps. It
|
|
27
|
+
**composes** the underlying skills/rules; it never re-implements them, and it
|
|
28
|
+
adds **no new flow** (it is invoked within discovery/implementation, honoring
|
|
29
|
+
`src/flows/README.md`).
|
|
30
|
+
|
|
31
|
+
Engage per [`rdp-gate`](../../contexts/execution/rdp-gate.md): skip on trivial
|
|
32
|
+
tasks; on a strong-reasoning host run **light / as suggestion** (it self-
|
|
33
|
+
coordinates); on a standard host run the full chain.
|
|
34
|
+
|
|
35
|
+
## When to use
|
|
36
|
+
|
|
37
|
+
- A complex, ambiguous, or long-horizon task on a standard host.
|
|
38
|
+
- Work where the reasoning steps are interdependent (a missed grounding or skipped
|
|
39
|
+
verification compounds downstream).
|
|
40
|
+
|
|
41
|
+
Do NOT use for trivial / linear / fully-specified tasks (the gate filters these),
|
|
42
|
+
and do not let it duplicate the work of the skills it coordinates.
|
|
43
|
+
|
|
44
|
+
## When the agent should load this
|
|
45
|
+
|
|
46
|
+
- A task is complex / ambiguous / long-horizon and the host is a standard model.
|
|
47
|
+
- The reasoning steps are interdependent and a skipped link (grounding,
|
|
48
|
+
verification) would compound downstream.
|
|
49
|
+
- Several discipline skills would otherwise fire piecemeal — load this to make
|
|
50
|
+
them act as one ordered chain instead of a buffet of optional steps.
|
|
51
|
+
|
|
52
|
+
## Procedure — the chain it enforces
|
|
53
|
+
|
|
54
|
+
Each link **delegates** to the artifact that owns it (no duplication):
|
|
55
|
+
|
|
56
|
+
1. **ground** — close constraints/tools/info-gaps before designing
|
|
57
|
+
([`think-before-action` § Environment grounding](../../rules/think-before-action.md)).
|
|
58
|
+
2. **intent** — state the inferred goal + one recommendation, standard host only
|
|
59
|
+
([`improve-before-implement` § Intent inference](../../rules/improve-before-implement.md)).
|
|
60
|
+
3. **notes** — hypotheses/predictions/decisions/uncertainty to the notes file, not
|
|
61
|
+
the response ([`notes-first-reasoning`](../../rules/notes-first-reasoning.md)).
|
|
62
|
+
4. **gather** — resolve the load-bearing unknown first
|
|
63
|
+
([`complexity-first-planning`](../complexity-first-planning/SKILL.md)); dispatch
|
|
64
|
+
independent subtasks async ([`subagent-orchestration` § RDP](../subagent-orchestration/SKILL.md)).
|
|
65
|
+
5. **audit** — check progress against real tool results
|
|
66
|
+
([`verify-before-complete`](../../rules/verify-before-complete.md)).
|
|
67
|
+
6. **verify** — fresh-context verifier on the structural-complexity gate
|
|
68
|
+
([`adversarial-review` § RDP](../adversarial-review/SKILL.md)).
|
|
69
|
+
|
|
70
|
+
## Fail-safe
|
|
71
|
+
|
|
72
|
+
If the orchestrator does not fire (gate off, or the host skips it), the
|
|
73
|
+
individual skills/rules still apply on their own triggers — the discipline
|
|
74
|
+
degrades gracefully to the distributed extensions rather than disappearing. The
|
|
75
|
+
orchestrator's value is **coherence** (the links happen in order, with handoffs),
|
|
76
|
+
not exclusivity.
|
|
77
|
+
|
|
78
|
+
## Output
|
|
79
|
+
|
|
80
|
+
The task's actual deliverable — produced through the chain. Reasoning stays in the
|
|
81
|
+
notes file; the response leads with the outcome + its evidence.
|
|
82
|
+
|
|
83
|
+
## Do NOT
|
|
84
|
+
|
|
85
|
+
- Re-implement grounding / verification / planning here — **delegate**.
|
|
86
|
+
- Create a new flow or a standalone pack — this is a skill invoked within existing flows.
|
|
87
|
+
- Run the full chain on a strong-reasoning host or a trivial task — the gate says light/off.
|
|
88
|
+
|
|
89
|
+
## Gotchas
|
|
90
|
+
|
|
91
|
+
- **Buffet collapse.** Without the orchestrator, the discipline skills fire
|
|
92
|
+
independently and the chain's *order* is lost (verification before grounding,
|
|
93
|
+
notes never written). The whole value is the ordered handoff — running the
|
|
94
|
+
links out of sequence is the failure this skill prevents.
|
|
95
|
+
- **Duplication creep.** Inlining a delegated step's logic here (re-doing the
|
|
96
|
+
grounding instead of pointing at `think-before-action`) silently forks the
|
|
97
|
+
behavior; the two copies then drift. Always delegate, never re-implement.
|
|
98
|
+
- **Wrong host, full chain.** Running every link on a strong-reasoning host wastes
|
|
99
|
+
tokens and reads as nagging — the gate says light/suggestion there. Forcing the
|
|
100
|
+
full chain regardless of host is a cost regression, not rigor.
|
|
101
|
+
|
|
102
|
+
## Related Skills
|
|
103
|
+
|
|
104
|
+
**WHEN to use this**
|
|
105
|
+
|
|
106
|
+
- A complex / ambiguous / long-horizon task on a standard host where the reasoning
|
|
107
|
+
links are interdependent.
|
|
108
|
+
- Several discipline skills would otherwise fire piecemeal and need ordering.
|
|
109
|
+
|
|
110
|
+
**WHEN NOT to use this**
|
|
111
|
+
|
|
112
|
+
- Trivial / linear / fully-specified tasks — the
|
|
113
|
+
[`rdp-gate`](../../contexts/execution/rdp-gate.md) filters these.
|
|
114
|
+
- A single discipline step in isolation — invoke that skill/rule directly
|
|
115
|
+
([`think-before-action`](../../rules/think-before-action.md),
|
|
116
|
+
[`verify-before-complete`](../../rules/verify-before-complete.md)) instead of the
|
|
117
|
+
whole chain.
|
|
118
|
+
- Needing the rationale behind the protocol — read
|
|
119
|
+
[`frontier-reasoning-operating-profile`](../../../../docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md).
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill": "reasoning-orchestrator",
|
|
3
|
+
"description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers complex / ambiguous / long-horizon work on a standard host where the reasoning steps are interdependent; should-not covers trivial / linear tasks, strong-host self-coordination, and single-discipline neighbors.",
|
|
4
|
+
"queries": [
|
|
5
|
+
{"q": "refactor the entire billing module to be cleaner and safer", "trigger": true},
|
|
6
|
+
{"q": "build this feature end to end from a vague brief — figure out the steps", "trigger": true},
|
|
7
|
+
{"q": "investigate this flaky multi-service failure and fix it properly", "trigger": true},
|
|
8
|
+
{"q": "take this ambiguous ticket and drive it to a verified implementation", "trigger": true},
|
|
9
|
+
{"q": "plan and implement the migration with checks at each stage", "trigger": true},
|
|
10
|
+
{"q": "rename this variable", "trigger": false, "note": "trivial — gate off"},
|
|
11
|
+
{"q": "format this file", "trigger": false, "note": "trivial"},
|
|
12
|
+
{"q": "just write the regex for an email", "trigger": false, "note": "single linear step"},
|
|
13
|
+
{"q": "only run the test suite and report", "trigger": false, "note": "single-discipline (verify), no chain to coordinate"},
|
|
14
|
+
{"q": "add a one-line log statement here", "trigger": false, "note": "trivial"}
|
|
15
|
+
]
|
|
16
|
+
}
|
|
@@ -84,11 +84,12 @@ For each comment classified as blocking/important:
|
|
|
84
84
|
for a reason
|
|
85
85
|
* **Consult memory for prior context.** Via
|
|
86
86
|
[`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md),
|
|
87
|
-
call `retrieve(types=["historical-patterns"
|
|
87
|
+
call `retrieve(types=["historical-patterns"],
|
|
88
88
|
keys=<files in the review>, limit=3)`. A registered historical pattern
|
|
89
|
-
may confirm the reviewer's concern (accept)
|
|
90
|
-
|
|
91
|
-
|
|
89
|
+
may confirm the reviewer's concern (accept). For architectural rationale
|
|
90
|
+
("why is the current shape intentional?"), check the ADR index
|
|
91
|
+
[`docs/decisions/INDEX.md`](../../../docs/decisions/INDEX.md) — push back
|
|
92
|
+
with the cited ADR number.
|
|
92
93
|
|
|
93
94
|
### 4. Decide: accept, push back, or escalate
|
|
94
95
|
|
|
@@ -178,8 +179,7 @@ When reporting back to the user after handling review:
|
|
|
178
179
|
## When to hand over to another skill / command
|
|
179
180
|
|
|
180
181
|
* Executing the fixes across many comments → [`fix-pr-comments`](../../commands/fix-pr-comments.md)
|
|
181
|
-
(handles both bot +
|
|
182
|
-
[`fix-pr-developer-comments`](../../commands/fix-pr-developer-comments.md)
|
|
182
|
+
(handles both bot + human reviewers in one pass)
|
|
183
183
|
* Running the full verification gate before pushing replies →
|
|
184
184
|
[`verify-before-complete`](../verify-before-complete/SKILL.md)
|
|
185
185
|
* Writing the commit message that references the review →
|
|
@@ -183,7 +183,7 @@ Before emitting the envelope, run these three scans. Each is a fast pass; failur
|
|
|
183
183
|
2. **Placeholder / TODO scan** — the rendered envelope contains no `<placeholder>`, `TODO`, `FIXME`, `tbd`, `???`, `XXX` strings. The literal angle-bracket placeholders in the template (`<one sentence …>`, `<bullet>`) must be replaced with concrete text before emission.
|
|
184
184
|
3. **Type / shape consistency** — every named file, module, route, or command in the AC matches the project's existing conventions. If the prompt names `auth.service.ts` but the codebase uses `AuthService.php`, surface the mismatch in *Assumptions* rather than adopting the prompt's spelling.
|
|
185
185
|
|
|
186
|
-
Source: adapted from
|
|
186
|
+
Source: adapted from an external reference `writing-plans/SKILL.md` § Self-Review (v5.1.0).
|
|
187
187
|
|
|
188
188
|
## Band-action mapping
|
|
189
189
|
|
|
@@ -272,7 +272,7 @@ Run these three scans on the rendered output before the close-prompt. Each is a
|
|
|
272
272
|
|
|
273
273
|
Self-review is mechanical (gaps, leftovers, naming drift); persona voices and orchestration outputs handle reasoning critique. Both run; neither replaces the other.
|
|
274
274
|
|
|
275
|
-
Source: adapted from
|
|
275
|
+
Source: adapted from an external reference `writing-plans/SKILL.md` § Self-Review (v5.1.0).
|
|
276
276
|
|
|
277
277
|
## Close-prompt (mandatory final step)
|
|
278
278
|
|
|
@@ -136,6 +136,6 @@ Cite the snapshot path so the consumer skill can read it.
|
|
|
136
136
|
## Provenance
|
|
137
137
|
|
|
138
138
|
- Upstream tool: https://github.com/yamadashy/repomix (MIT).
|
|
139
|
-
- Adopted from:
|
|
139
|
+
- Adopted from: an external reference (MIT, © 2025 an external reference) — wrapper-style adoption, no upstream code vendored.
|
|
140
140
|
- Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `repomix`).
|
|
141
141
|
- Iron-Law floor: `non-destructive-by-default`, `missing-tool-handling`, `tool-safety`.
|
|
@@ -135,7 +135,7 @@ Telemetry / APM → strip from request/response captures; allowlist headers.
|
|
|
135
135
|
|
|
136
136
|
## Provenance
|
|
137
137
|
|
|
138
|
-
- Adopted from:
|
|
138
|
+
- Adopted from: an external reference (MIT, © 2025 an external reference) — **Sunset Policy applied**: 346-line provider cookbook reduced to a ~140-line decision framework; per-provider deep-dives externalized to upstream docs below.
|
|
139
139
|
- Externalized provider docs:
|
|
140
140
|
- HashiCorp Vault: https://developer.hashicorp.com/vault/docs · https://developer.hashicorp.com/vault/docs/secrets/databases
|
|
141
141
|
- AWS Secrets Manager: https://docs.aws.amazon.com/secretsmanager/ · rotation: https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html
|
|
@@ -49,6 +49,13 @@ judge is a fresh pair of eyes. If `.agent-settings.yml` resolves to
|
|
|
49
49
|
identical implementer and judge models, surface the mismatch before
|
|
50
50
|
running — do not silently continue.
|
|
51
51
|
|
|
52
|
+
## RDP: parallel async dispatch by default
|
|
53
|
+
|
|
54
|
+
Within the Reasoning Discipline Protocol, dispatch independent subtasks to
|
|
55
|
+
parallel subagents **by default** and keep working while they run (async), rather
|
|
56
|
+
than blocking on each return — intervene only if one goes off track. Engage per
|
|
57
|
+
[`rdp-gate`](../../contexts/execution/rdp-gate.md).
|
|
58
|
+
|
|
52
59
|
## The seven modes
|
|
53
60
|
|
|
54
61
|
Each mode has a decision row: when to use, when not, and the expected
|
|
@@ -60,8 +67,8 @@ model pairing. Defaults come from
|
|
|
60
67
|
Descriptive, not enforced. Documents the **expected agent-to-agent
|
|
61
68
|
communication topology** so consumers can predict latency, failure
|
|
62
69
|
modes, and where consensus is required. Cited from
|
|
63
|
-
|
|
64
|
-
row 7 (
|
|
70
|
+
an internal findings note (local-only) <!-- council-ref-allowed: ADR decision trace for topology anti-drift defaults -->
|
|
71
|
+
row 7 (the external runtime's `hierarchical, 6–8 agents, raft consensus` anti-drift
|
|
65
72
|
default).
|
|
66
73
|
|
|
67
74
|
| Mode | Topology | Anti-drift default | Notes |
|
|
@@ -74,7 +81,7 @@ default).
|
|
|
74
81
|
| judge-with-debate | `hierarchical-mesh` | 2 judges · 1 meta-judge | Judges debate (mesh edge); meta-judge reconciles (hierarchical). |
|
|
75
82
|
| do-in-worktrees | `adaptive` | per-step topology of the underlying mode | Each worktree picks its own shape; chain is hierarchical. |
|
|
76
83
|
|
|
77
|
-
**Anti-drift default** (
|
|
84
|
+
**Anti-drift default** (the external runtime convention, descriptive only):
|
|
78
85
|
`hierarchical, 6–8 agents, raft consensus`. Consumers free to
|
|
79
86
|
override per orchestration — the table is the **starting point**,
|
|
80
87
|
not a constraint. Topology is metadata for capacity planning, not
|
|
@@ -158,7 +158,7 @@ Gate: a feature is not complete until a failing-then-passing test cycle ran for
|
|
|
158
158
|
|
|
159
159
|
## Provenance
|
|
160
160
|
|
|
161
|
-
- Adopted from:
|
|
161
|
+
- Adopted from: an external reference (MIT, © 2025 an external reference).
|
|
162
162
|
- Cross-linked: [`pest-testing`](../pest-testing/SKILL.md), [`test-driven-development`](../test-driven-development/SKILL.md), [`judge-test-coverage`](../judge-test-coverage/SKILL.md).
|
|
163
163
|
- Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `testing-anti-patterns`).
|
|
164
164
|
- Iron-Law floor: `verify-before-complete`, `skill-quality`.
|
|
@@ -61,7 +61,7 @@ the rationalization, then reject it:
|
|
|
61
61
|
|
|
62
62
|
## Provenance
|
|
63
63
|
|
|
64
|
-
- Adapted from
|
|
64
|
+
- Adapted from an external reference `testing/anti-patterns.md`.
|
|
65
65
|
- Council convergence (anthropic/claude-sonnet-4-5 + openai/gpt-4o,
|
|
66
66
|
2026-05-07): both members ADOPT — the catalogue surfaces specific
|
|
67
67
|
rationalization patterns that would otherwise leak past code review.
|
|
@@ -80,7 +80,7 @@ INTENT
|
|
|
80
80
|
| `agent-handoff` | `.claude/skills/agent-handoff/SKILL.md` | `handoff`, `fresh`, `chat`, `context` | Context envelope for fresh-chat continuation |
|
|
81
81
|
| `direct-answers` | `.agent-src.uncondensed/rules/direct-answers.md` | `brevity`, `flattery`, `severity`, `tiered` | Iron-Law brevity floor (kernel) |
|
|
82
82
|
| `markitdown` | upstream: github.com/microsoft/markitdown | `PDF`, `DOCX`, `HTML`, `convert` | Document → markdown converter (authoritative-link only) |
|
|
83
|
-
| `/cost:report` | TBD —
|
|
83
|
+
| `/cost:report` | TBD — an internal roadmap (local-only) | `cost`, `model spend`, `budget` | Per-session cost telemetry (planned) |
|
|
84
84
|
|
|
85
85
|
## Output format
|
|
86
86
|
|
|
@@ -11,6 +11,5 @@ agents/memory/intake/*.jsonl merge=union eol=lf
|
|
|
11
11
|
agents/memory/ownership/*.yml text eol=lf
|
|
12
12
|
agents/memory/historical-patterns/*.yml text eol=lf
|
|
13
13
|
agents/memory/domain-invariants/*.yml text eol=lf
|
|
14
|
-
agents/memory/architecture-decisions/*.yml text eol=lf
|
|
15
14
|
agents/memory/incident-learnings/*.yml text eol=lf
|
|
16
15
|
agents/memory/product-rules/*.yml text eol=lf
|
|
@@ -116,9 +116,9 @@ modules:
|
|
|
116
116
|
|
|
117
117
|
# --- Memory layer (optional) ---
|
|
118
118
|
#
|
|
119
|
-
# Opt-in signal for the
|
|
120
|
-
#
|
|
121
|
-
#
|
|
119
|
+
# Opt-in signal for the repo-shared, file-backed curated-memory files
|
|
120
|
+
# under `agents/memory/`. If omitted, memory features stay inert —
|
|
121
|
+
# no writes, no reads, no nagging.
|
|
122
122
|
memory:
|
|
123
123
|
# Enable curated memory files under `agents/memory/` as part of
|
|
124
124
|
# this repo's dogfooding of its own memory conventions. Only flip
|
|
@@ -278,7 +278,7 @@ locked_keys: []
|
|
|
278
278
|
# files live here when memory.dogfood is true. These paths are for
|
|
279
279
|
# reference only — no enforcement is done from this file.
|
|
280
280
|
references:
|
|
281
|
-
|
|
281
|
+
# Architecture decisions live in ADRs (docs/decisions/), not curated memory.
|
|
282
282
|
domain_invariants: agents/memory/domain-invariants/
|
|
283
283
|
incident_learnings: agents/memory/incident-learnings/
|
|
284
284
|
product_rules: agents/memory/product-rules/
|
|
@@ -50,8 +50,7 @@ REQUIRED_KEYS = {
|
|
|
50
50
|
VALID_STATUS = {"active", "deprecated", "archived"}
|
|
51
51
|
VALID_CONFIDENCE = {"low", "medium", "high"}
|
|
52
52
|
KNOWN_TYPES = {
|
|
53
|
-
"domain-invariants", "
|
|
54
|
-
"incident-learnings", "product-rules",
|
|
53
|
+
"domain-invariants", "incident-learnings", "product-rules",
|
|
55
54
|
}
|
|
56
55
|
|
|
57
56
|
# Redaction heuristics — plain-regex, deliberately conservative.
|
|
@@ -36,7 +36,7 @@ from typing import Any
|
|
|
36
36
|
INTAKE_ROOT = Path("agents/memory/intake")
|
|
37
37
|
VALID_TYPES = {
|
|
38
38
|
"historical-patterns", "incident-learnings", "ownership",
|
|
39
|
-
"domain-invariants", "
|
|
39
|
+
"domain-invariants", "product-rules",
|
|
40
40
|
}
|
|
41
41
|
REQUIRED_INTAKE = ("id", "entry_type", "path", "body")
|
|
42
42
|
PATTERN_MIN_PATHS = 2
|