@event4u/agent-config 3.3.0 → 4.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/README.md +2 -2
- package/.agent-src/commands/agent-handoff.md +31 -2
- package/.agent-src/commands/agent-status.md +5 -5
- package/.agent-src/commands/agents/audit.md +8 -8
- package/.agent-src/commands/agents/init.md +25 -1
- package/.agent-src/commands/agents/optimize.md +3 -3
- package/.agent-src/commands/agents/user.md +1 -1
- package/.agent-src/commands/agents.md +1 -1
- package/.agent-src/commands/analyze-reference-repo.md +1 -1
- package/.agent-src/commands/check-current-md.md +8 -8
- package/.agent-src/commands/{compress.md → condense.md} +55 -55
- package/.agent-src/commands/context/create.md +7 -4
- package/.agent-src/commands/context/refactor.md +3 -1
- package/.agent-src/commands/feature/dev.md +1 -1
- package/.agent-src/commands/feature/explore.md +1 -1
- package/.agent-src/commands/feature/plan.md +10 -8
- package/.agent-src/commands/feature/refactor.md +3 -1
- package/.agent-src/commands/feature/roadmap.md +7 -4
- package/.agent-src/commands/fix/portability.md +3 -3
- package/.agent-src/commands/fix/refs.md +4 -4
- package/.agent-src/commands/ghostwriter.md +2 -2
- package/.agent-src/commands/memory/learn-low-impact.md +3 -3
- package/.agent-src/commands/module/explore.md +34 -8
- package/.agent-src/commands/optimize/agents-dir.md +9 -7
- package/.agent-src/commands/optimize/augmentignore.md +2 -2
- package/.agent-src/commands/optimize/skills.md +9 -9
- package/.agent-src/commands/post-as.md +1 -1
- package/.agent-src/commands/project-analyze.md +2 -2
- package/.agent-src/commands/project-health.md +3 -2
- package/.agent-src/commands/research/deep.md +1 -1
- package/.agent-src/commands/research/report.md +1 -1
- package/.agent-src/commands/research.md +1 -1
- package/.agent-src/commands/roadmap/ai-council.md +1 -1
- package/.agent-src/commands/roadmap/create.md +9 -4
- package/.agent-src/commands/rule-compliance-audit.md +1 -1
- package/.agent-src/commands/upstream-contribute.md +14 -14
- package/.agent-src/commands/video/from-script.md +1 -1
- package/.agent-src/commands/video/scene.md +1 -1
- package/.agent-src/commands/video/stitch.md +1 -1
- package/.agent-src/commands/video/storyboard.md +1 -1
- package/.agent-src/commands/video.md +1 -1
- package/.agent-src/contexts/augment-infrastructure.md +1 -1
- package/.agent-src/contexts/authority/commit-mechanics.md +15 -0
- package/.agent-src/contexts/authority/kernel-rule-edits.md +3 -3
- package/.agent-src/contexts/authority/scope-mechanics.md +1 -1
- package/.agent-src/contexts/communication/rules-auto/augment-source-of-truth-mechanics.md +28 -28
- package/.agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +4 -4
- package/.agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +2 -2
- package/.agent-src/contexts/contracts/artifact-engagement-flow.md +6 -6
- package/.agent-src/contexts/contracts/command-suggestion-flow.md +3 -3
- package/.agent-src/contexts/contracts/emergency-triage-block.md +4 -4
- package/.agent-src/contexts/contracts/frugality-charter.md +3 -3
- package/.agent-src/contexts/documentation-hierarchy.md +14 -7
- package/.agent-src/contexts/execution/autonomy-examples.md +1 -1
- package/.agent-src/contexts/execution/cheap-question-mechanics.md +39 -2
- package/.agent-src/contexts/execution/roadmap-process-loop.md +28 -5
- package/.agent-src/contexts/override-system.md +5 -5
- package/.agent-src/ghostwriter/fictional-fixture-v1.md +1 -1
- package/.agent-src/personas/advisors/first-principles.md +1 -1
- package/.agent-src/personas/hollywood-director.md +1 -1
- package/.agent-src/rules/architecture.md +5 -1
- package/.agent-src/rules/augment-edit-discipline.md +5 -5
- package/.agent-src/rules/augment-source-of-truth.md +15 -15
- package/.agent-src/rules/commit-conventions.md +1 -1
- package/.agent-src/rules/commit-policy.md +10 -0
- package/.agent-src/rules/domain-adoption-policy.md +3 -3
- package/.agent-src/rules/fast-path-marker-visibility.md +3 -3
- package/.agent-src/rules/finance-safety-floor.md +1 -1
- package/.agent-src/rules/framework-neutrality-in-generic-skills.md +8 -8
- package/.agent-src/rules/git-history-discipline.md +1 -1
- package/.agent-src/rules/improve-before-implement.md +2 -2
- package/.agent-src/rules/language-and-tone.md +2 -2
- package/.agent-src/rules/media-governance-routing.md +5 -5
- package/.agent-src/rules/no-attribution-footers.md +1 -0
- package/.agent-src/rules/no-cheap-questions.md +3 -0
- package/.agent-src/rules/no-decorative-emojis-in-git-surfaces.md +111 -0
- package/.agent-src/rules/no-pr-progress-comments.md +118 -0
- package/.agent-src/rules/no-roadmap-references.md +3 -3
- package/.agent-src/rules/non-destructive-by-default.md +1 -1
- package/.agent-src/rules/persona-governance.md +3 -3
- package/.agent-src/rules/preservation-guard.md +15 -15
- package/.agent-src/rules/roadmap-ci-steps-policy.md +7 -3
- package/.agent-src/rules/rule-type-governance.md +1 -1
- package/.agent-src/rules/skill-quality.md +1 -1
- package/.agent-src/rules/{caveman-speak.md → telegraph-speak.md} +15 -15
- package/.agent-src/rules/token-optimizer-maintenance.md +6 -6
- package/.agent-src/skills/agent-docs-writing/SKILL.md +17 -11
- package/.agent-src/skills/agents-md-thin-root/SKILL.md +9 -9
- package/.agent-src/skills/check-refs/SKILL.md +2 -2
- package/.agent-src/skills/code-refactoring/SKILL.md +2 -2
- package/.agent-src/skills/command-writing/SKILL.md +19 -19
- package/.agent-src/skills/comp-banding/SKILL.md +1 -1
- package/.agent-src/skills/condense-memory/SKILL.md +131 -0
- package/.agent-src/skills/context-authoring/SKILL.md +2 -2
- package/.agent-src/skills/context-document/SKILL.md +5 -3
- package/.agent-src/skills/copilot-agents-optimization/SKILL.md +3 -3
- package/.agent-src/skills/description-assist/SKILL.md +2 -2
- package/.agent-src/skills/git-workflow/SKILL.md +1 -1
- package/.agent-src/skills/guideline-writing/SKILL.md +5 -5
- package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +4 -4
- package/.agent-src/skills/lint-skills/SKILL.md +3 -3
- package/.agent-src/skills/md-language-check/SKILL.md +2 -2
- package/.agent-src/skills/module-detect-on-the-fly/SKILL.md +138 -0
- package/.agent-src/skills/module-management/SKILL.md +166 -94
- package/.agent-src/skills/override-management/SKILL.md +1 -1
- package/.agent-src/skills/persona-writing/SKILL.md +5 -5
- package/.agent-src/skills/positioning-strategy/SKILL.md +1 -1
- package/.agent-src/skills/project-docs/SKILL.md +6 -4
- package/.agent-src/skills/readme-reviewer/SKILL.md +2 -2
- package/.agent-src/skills/roadmap-management/SKILL.md +13 -1
- package/.agent-src/skills/roadmap-writing/SKILL.md +4 -2
- package/.agent-src/skills/rule-refactor/SKILL.md +5 -5
- package/.agent-src/skills/rule-writing/SKILL.md +18 -18
- package/.agent-src/skills/script-writing/SKILL.md +1 -1
- package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +6 -6
- package/.agent-src/skills/skill-management/SKILL.md +21 -21
- package/.agent-src/skills/skill-reviewer/SKILL.md +2 -2
- package/.agent-src/skills/skill-writing/SKILL.md +8 -8
- package/.agent-src/skills/skill-writing/evals/triggers.json +1 -1
- package/.agent-src/skills/token-optimizer/SKILL.md +4 -4
- package/.agent-src/skills/unit-economics-modeling/SKILL.md +1 -1
- package/.agent-src/skills/upstream-contribute/SKILL.md +17 -17
- package/.agent-src/templates/AGENTS.md +1 -0
- package/.agent-src/templates/agent-settings.md +24 -13
- package/.agent-src/templates/agents/agent-project-settings.example.yml +61 -2
- package/.agent-src/templates/command.md +5 -5
- package/.agent-src/templates/contexts.md +1 -1
- package/.agent-src/templates/copilot-instructions.md +8 -8
- package/.agent-src/templates/features.md +1 -1
- package/.agent-src/templates/hooks/pre-commit-frontmatter +2 -2
- package/.agent-src/templates/hooks/pre-commit-roadmap-progress +3 -3
- package/.agent-src/templates/persona.md +2 -2
- package/.agent-src/templates/roadmaps.md +1 -1
- package/.agent-src/templates/rule.md +13 -13
- package/.agent-src/templates/scripts/memory_lookup.py +1 -1
- package/.agent-src/templates/scripts/memory_status.py +2 -2
- package/.agent-src/templates/scripts/work_engine/_lib/agent_settings.py +195 -1
- package/.agent-src/templates/scripts/work_engine/orchestration.py +1 -1
- package/.agent-src/templates/skill-archive-note.md +5 -5
- package/.agent-src/templates/skill.md +1 -1
- package/.claude-plugin/marketplace.json +4 -4
- package/AGENTS.md +16 -17
- package/CHANGELOG.md +181 -3
- package/CONTRIBUTING.md +31 -12
- package/README.md +18 -10
- package/config/agent-settings.template.yml +22 -2
- package/config/discovery/unassigned-artefacts.yml +24 -24
- package/config/profiles/full.ini +1 -1
- package/dist/cli/agent-config.js +52 -3
- package/dist/cli/agent-config.js.map +1 -1
- package/dist/cli/commands/uiServe.js +9 -0
- package/dist/cli/commands/uiServe.js.map +1 -1
- package/dist/cli/registry.js +2 -1
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +649 -606
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +4 -4
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +439 -437
- package/dist/discovery/trust-report.md +5 -5
- package/dist/discovery/workspaces.json +450 -448
- package/dist/install/apply.js +238 -0
- package/dist/install/apply.js.map +1 -0
- package/dist/install/atomic.js +92 -0
- package/dist/install/atomic.js.map +1 -0
- package/dist/install/bridges/augment.js +20 -0
- package/dist/install/bridges/augment.js.map +1 -0
- package/dist/install/bridges/claude.js +44 -0
- package/dist/install/bridges/claude.js.map +1 -0
- package/dist/install/bridges/cline.js +69 -0
- package/dist/install/bridges/cline.js.map +1 -0
- package/dist/install/bridges/copilot.js +28 -0
- package/dist/install/bridges/copilot.js.map +1 -0
- package/dist/install/bridges/cursor.js +34 -0
- package/dist/install/bridges/cursor.js.map +1 -0
- package/dist/install/bridges/gemini.js +39 -0
- package/dist/install/bridges/gemini.js.map +1 -0
- package/dist/install/bridges/index.js +88 -0
- package/dist/install/bridges/index.js.map +1 -0
- package/dist/install/bridges/marker-content.js +153 -0
- package/dist/install/bridges/marker-content.js.map +1 -0
- package/dist/install/bridges/markers.js +42 -0
- package/dist/install/bridges/markers.js.map +1 -0
- package/dist/install/bridges/types.js +31 -0
- package/dist/install/bridges/types.js.map +1 -0
- package/dist/install/bridges/vscode.js +26 -0
- package/dist/install/bridges/vscode.js.map +1 -0
- package/dist/install/bridges/windsurf.js +35 -0
- package/dist/install/bridges/windsurf.js.map +1 -0
- package/dist/install/conflict.js +196 -0
- package/dist/install/conflict.js.map +1 -0
- package/dist/install/detect.js +218 -0
- package/dist/install/detect.js.map +1 -0
- package/dist/install/paths.js +82 -0
- package/dist/install/paths.js.map +1 -0
- package/dist/install/plan.js +157 -0
- package/dist/install/plan.js.map +1 -0
- package/dist/install/txlog.js +140 -0
- package/dist/install/txlog.js.map +1 -0
- package/dist/install/types.js +19 -0
- package/dist/install/types.js.map +1 -0
- package/dist/install/wizard-plan.js +184 -0
- package/dist/install/wizard-plan.js.map +1 -0
- package/dist/mcp/registry-manifest.json +4 -4
- package/dist/router.json +67 -19
- package/dist/server/app.js +6 -0
- package/dist/server/app.js.map +1 -1
- package/dist/server/routes/install.js +547 -0
- package/dist/server/routes/install.js.map +1 -0
- package/dist/server/routes/wizard.js +301 -6
- package/dist/server/routes/wizard.js.map +1 -1
- package/dist/server/routes/workspace.js +396 -0
- package/dist/server/routes/workspace.js.map +1 -0
- package/dist/server/schemas/settings.js +4 -3
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/ui/assets/index-BXZILUxe.css +1 -0
- package/dist/ui/assets/index-DLEuEW1V.js +35 -0
- package/dist/ui/assets/index-DLEuEW1V.js.map +1 -0
- package/dist/ui/index.html +2 -2
- package/docs/MIGRATION.md +1 -1
- package/docs/adrs/cost/0001-hard-stop-hook.md +1 -1
- package/docs/adrs/router/0001-three-tier-routing.md +4 -4
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +1 -1
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +4 -4
- package/docs/adrs/{caveman → telegraph}/0001-default-off-until-bench.md +9 -9
- package/docs/adrs/telegraph/README.md +9 -0
- package/docs/architecture/augment-projection.md +4 -4
- package/docs/architecture/claude-bundle.md +1 -1
- package/docs/architecture/current-onboard-baseline.md +3 -3
- package/docs/architecture/multi-tool-projection.md +10 -10
- package/docs/architecture/source-projection.md +27 -27
- package/docs/architecture.md +19 -15
- package/docs/archive/CHANGELOG-pre-2.11.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-2.15.0.md +3 -3
- package/docs/archive/CHANGELOG-pre-2.16.0.md +1 -1
- package/docs/archive/CHANGELOG-pre-2.2.0.md +70 -70
- package/docs/archive/CHANGELOG-pre-2.20.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-2.25.0.md +15 -15
- package/docs/archive/CHANGELOG-pre-3.0.0.md +4 -4
- package/docs/archive/CHANGELOG-pre-3.1.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-3.2.0.md +3 -3
- package/docs/benchmark.md +65 -0
- package/docs/benchmarks.md +16 -16
- package/docs/catalog.md +17 -15
- package/docs/contracts/CHANGELOG-conventions.md +1 -1
- package/docs/contracts/STABILITY.md +2 -2
- package/docs/contracts/adoption-signal-floor.md +110 -0
- package/docs/contracts/adr-chat-history-split.md +4 -4
- package/docs/contracts/adr-command-suggestion.md +4 -4
- package/docs/contracts/adr-gtm-context-spine.md +1 -1
- package/docs/contracts/adr-implement-ticket-runtime.md +4 -4
- package/docs/contracts/adr-install-user-type-axis.md +1 -1
- package/docs/contracts/adr-layout.md +2 -2
- package/docs/contracts/adr-product-ui-track.md +10 -10
- package/docs/contracts/adr-user-types-axis.md +3 -3
- package/docs/contracts/adr-wing4-context-spine.md +1 -1
- package/docs/contracts/agent-memory-contract.md +3 -3
- package/docs/contracts/agents-md-tech-stack.md +2 -2
- package/docs/contracts/ai-council-config.md +2 -2
- package/docs/contracts/at-rest-encryption.md +4 -0
- package/docs/contracts/audit-log-v1.md +1 -1
- package/docs/contracts/benchmark-ab-contract.md +101 -0
- package/docs/contracts/benchmark-corpus-spec.md +1 -1
- package/docs/contracts/branch-protection-policy.md +98 -0
- package/docs/contracts/ci-cost-budget.md +106 -0
- package/docs/contracts/ci-green-floor.md +141 -0
- package/docs/contracts/command-clusters.md +6 -6
- package/docs/contracts/command-surface-tiers.md +2 -2
- package/docs/contracts/command-taxonomy.md +2 -2
- package/docs/contracts/{compression-default-kill-criterion.md → condensation-default-kill-criterion.md} +29 -29
- package/docs/contracts/config-presets.md +1 -1
- package/docs/contracts/context-paths.md +3 -3
- package/docs/contracts/context-spine.md +1 -1
- package/docs/contracts/cost-summary-schema.md +12 -12
- package/docs/contracts/cross-wing-handoff.md +4 -4
- package/docs/contracts/daily-workspace.md +4 -0
- package/docs/contracts/decision-trace-v1.md +2 -2
- package/docs/contracts/discovery-manifest.md +4 -4
- package/docs/contracts/explain-modes.md +4 -0
- package/docs/contracts/file-ownership-matrix.json +3493 -3318
- package/docs/contracts/file-ownership-matrix.md +3 -3
- package/docs/contracts/frontmatter-contract.md +4 -4
- package/docs/contracts/ghostwriter-schema.md +3 -3
- package/docs/contracts/gui-wizard.md +1 -1
- package/docs/contracts/harness-expectations.md +123 -0
- package/docs/contracts/host-agent-protocol.md +4 -0
- package/docs/contracts/implement-ticket-flow.md +9 -9
- package/docs/contracts/install-scopes.md +77 -0
- package/docs/contracts/iron-law-overrides.txt +1 -1
- package/docs/contracts/kernel-membership.md +26 -26
- package/docs/contracts/linear-ai-rules-inclusion.md +1 -1
- package/docs/contracts/linter-structural-model.md +2 -2
- package/docs/contracts/load-context-budget-model.md +4 -4
- package/docs/contracts/load-context-schema.md +13 -13
- package/docs/contracts/local-analytics.md +4 -0
- package/docs/contracts/local-knowledge-ingestion.md +1 -1
- package/docs/contracts/mcp-cloud-scope.md +2 -2
- package/docs/contracts/mcp-phase-1-scope.md +3 -3
- package/docs/contracts/measurement-baseline.md +5 -5
- package/docs/contracts/mental-models.md +30 -30
- package/docs/contracts/multi-tool-projection-fidelity.md +4 -4
- package/docs/contracts/namespace.md +4 -4
- package/docs/contracts/orchestration-dsl-v1.md +7 -7
- package/docs/contracts/package-self-orientation.md +12 -12
- package/docs/contracts/persona-schema.md +6 -6
- package/docs/contracts/pilot/language-and-tone.md +1 -1
- package/docs/contracts/plain-language-surface.md +117 -0
- package/docs/contracts/profile-system.md +3 -3
- package/docs/contracts/release-pr-gating.md +103 -0
- package/docs/contracts/role-experience.md +3 -3
- package/docs/contracts/rule-classification.md +13 -13
- package/docs/contracts/rule-interactions.md +4 -4
- package/docs/contracts/rule-interactions.yml +30 -30
- package/docs/contracts/rule-priority-hierarchy.md +13 -13
- package/docs/contracts/rule-router.md +2 -2
- package/docs/contracts/safety-model.md +1 -1
- package/docs/contracts/skill-distribution-channels.md +61 -0
- package/docs/contracts/skill-domains.md +2 -2
- package/docs/contracts/smoke-contracts.md +5 -5
- package/docs/contracts/telegraph-telemetry.md +83 -0
- package/docs/contracts/trust-and-safety.md +5 -5
- package/docs/contracts/ui-stack-extension.md +7 -7
- package/docs/contracts/ui-track-flow.md +9 -9
- package/docs/contracts/user-type-schema.md +4 -4
- package/docs/contracts/workflow-packs.md +4 -4
- package/docs/contracts/workspace-documents.md +4 -0
- package/docs/customization.md +28 -8
- package/docs/decisions/ADR-001-kernel-swap-deferred.md +6 -6
- package/docs/decisions/ADR-002-kernel-bucket-overrides.md +11 -11
- package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +2 -2
- package/docs/decisions/ADR-004-rule-governance-pruning.md +4 -4
- package/docs/decisions/ADR-005-subagent-worktrees.md +7 -7
- package/docs/decisions/ADR-011-domain-pack-readiness.md +6 -6
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +3 -3
- package/docs/decisions/ADR-015-discovery-manifest-contract.md +3 -3
- package/docs/decisions/ADR-017-monorepo-physical-layout.md +10 -10
- package/docs/decisions/ADR-018-trust-and-safety-layer.md +6 -6
- package/docs/decisions/ADR-019-router-json-dist-location.md +2 -2
- package/docs/decisions/ADR-020-global-only-consumer-scope.md +2 -2
- package/docs/decisions/ADR-021-deployment-shape.md +1 -1
- package/docs/decisions/ADR-022-daily-workspace-decomposition.md +1 -1
- package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +2 -2
- package/docs/decisions/ADR-028-root-layout.md +7 -7
- package/docs/decisions/ADR-029-multi-workspace-deferred.md +2 -2
- package/docs/decisions/ADR-rule-kernel-and-router.md +5 -5
- package/docs/deploy/team-deployment-posture.md +20 -0
- package/docs/development.md +17 -17
- package/docs/distribution/registries.md +32 -0
- package/docs/distribution/registry-submissions.md +85 -0
- package/docs/distribution/telemetry-schema.md +1 -1
- package/docs/getting-started-by-role.md +45 -3
- package/docs/getting-started.md +2 -2
- package/docs/guidelines/agent-infra/5w2h-analysis.md +3 -3
- package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +1 -1
- package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +3 -3
- package/docs/guidelines/agent-infra/carve-out-predicates.md +3 -3
- package/docs/guidelines/agent-infra/critical-thinking.md +4 -4
- package/docs/guidelines/agent-infra/direct-answers-demos.md +1 -1
- package/docs/guidelines/agent-infra/first-principles.md +2 -2
- package/docs/guidelines/agent-infra/inversion-thinking.md +5 -5
- package/docs/guidelines/agent-infra/layered-settings.md +56 -2
- package/docs/guidelines/agent-infra/mental-models.md +3 -3
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +2 -2
- package/docs/guidelines/agent-infra/rule-type-governance.md +1 -1
- package/docs/guidelines/agent-infra/scqa-framework.md +5 -5
- package/docs/guidelines/agent-infra/self-improvement-pipeline.md +2 -2
- package/docs/guidelines/agent-infra/six-hats.md +3 -3
- package/docs/guidelines/agent-infra/skill-quality-checklist.md +5 -5
- package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
- package/docs/guidelines/agent-infra/verify-before-complete-demos.md +1 -1
- package/docs/guidelines/augment-portability-patterns.md +4 -4
- package/docs/guidelines/cross-role-handoff.md +2 -2
- package/docs/guidelines/php/php-coding-patterns.md +1 -1
- package/docs/guidelines/prompt-templates.md +6 -6
- package/docs/maintainers/dev-mode.md +1 -1
- package/docs/mcp.md +1 -1
- package/docs/parity/bench.json +3 -3
- package/docs/parity/ruflo.md +2 -2
- package/docs/profiles.md +11 -11
- package/docs/quality.md +11 -11
- package/docs/safety.md +3 -3
- package/docs/setup/mcp-client-config.md +1 -1
- package/docs/setup/mcp-r2-bootstrap.md +1 -1
- package/docs/setup/mcp-server-docker.md +3 -3
- package/docs/setup/per-ide/windsurf.md +1 -1
- package/docs/skills-catalog.md +8 -7
- package/docs/troubleshooting.md +1 -1
- package/docs/walkthroughs/daily-workspace-a11y.md +87 -0
- package/llms.txt +7 -6
- package/package.json +1 -1
- package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
- package/scripts/_archive/README.md +2 -2
- package/scripts/_archive/_backfill_skill_domains.py +3 -3
- package/scripts/_archive/_bootstrap_tier_frontmatter.py +3 -3
- package/scripts/_archive/_p43_bodies.py +10 -10
- package/scripts/_archive/{_p43_compress.py → _p43_condense.py} +5 -5
- package/scripts/_archive/_p4_migrate.py +7 -7
- package/scripts/_archive/_phase2_shim_helper.py +1 -1
- package/scripts/_archive/_pilot_council_question.py +5 -5
- package/scripts/_cli/explain_last/inputs.py +1 -1
- 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 +195 -1
- package/scripts/_lib/agent_src.py +19 -19
- package/scripts/_lib/bench_ab_cache.py +162 -0
- package/scripts/_lib/bench_ab_scoring.py +209 -0
- package/scripts/_lib/{bench_caveman.py → bench_telegraph.py} +21 -21
- package/scripts/_lib/{bench_caveman_report.py → bench_telegraph_report.py} +21 -21
- package/scripts/_lib/claude_desktop_bundler.py +5 -5
- package/scripts/_lib/module_detection.py +223 -0
- package/scripts/_lib/scope_guard.sh +162 -0
- package/scripts/_phase4_bucket.py +3 -3
- package/scripts/_pilot_measure.py +4 -4
- package/scripts/_tmp_scan_framework_leakage.py +1 -1
- package/scripts/adoption_report.py +195 -0
- package/scripts/adoption_snapshot.py +219 -0
- package/scripts/adoption_status.py +166 -0
- package/scripts/ai-video/lib/parse-blueprint.sh +1 -1
- package/scripts/ai_council/advisors.py +5 -5
- package/scripts/ai_council/compile_corpus.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +3 -3
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +2 -2
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_inject_quiet_flag.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_v2.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_verbosity.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +3 -3
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_per_task.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +6 -6
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_rebalancing_audit.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_tier_retrofit.py +6 -6
- package/scripts/annotate_discovery.py +13 -13
- package/scripts/apply_modules_config.py +290 -0
- package/scripts/audit_adr_coverage.py +2 -2
- package/scripts/audit_auto_rules.py +2 -2
- package/scripts/audit_cloud_compatibility.py +3 -3
- package/scripts/audit_command_surface.py +9 -9
- package/scripts/audit_likelihood.py +2 -2
- package/scripts/audit_user_type_axis.py +2 -2
- package/scripts/bench_ab_cache_dispatch.py +68 -0
- package/scripts/bench_ab_clone.py +170 -0
- package/scripts/bench_ab_diff.py +227 -0
- package/scripts/bench_ab_integrity.py +143 -0
- package/scripts/bench_ab_run.py +235 -0
- package/scripts/bench_ab_task_runner.py +369 -0
- package/scripts/bench_ab_tracka_run.py +202 -0
- package/scripts/{bench_compress_memory.py → bench_condense_memory.py} +16 -16
- package/scripts/bench_run.py +33 -33
- package/scripts/bench_runner.py +2 -2
- package/scripts/bootstrap.sh +99 -0
- package/scripts/build_cloud_bundle.py +6 -6
- package/scripts/build_discovery_manifest.py +7 -7
- package/scripts/build_linear_digest.py +3 -3
- package/scripts/build_rule_trigger_matrix.py +8 -8
- package/scripts/chat_history.py +5 -5
- package/scripts/check_always_budget.py +11 -5
- package/scripts/check_augment_description_cap.py +3 -3
- package/scripts/check_cluster_patterns.py +2 -2
- package/scripts/check_command_count_messaging.py +3 -3
- package/scripts/{check_compression.py → check_condensation.py} +34 -34
- package/scripts/{check_compressed_paths.py → check_condensed_paths.py} +8 -8
- package/scripts/check_context_paths.py +7 -7
- package/scripts/check_council_layout.py +2 -2
- package/scripts/check_council_references.py +9 -9
- package/scripts/check_iron_law_prominence.py +2 -2
- package/scripts/check_kernel_rule_bundle.py +2 -2
- package/scripts/check_module_management_neutral.py +149 -0
- package/scripts/check_no_roadmap_refs.py +9 -9
- package/scripts/check_portability.py +3 -3
- package/scripts/check_public_catalog_links.py +4 -4
- package/scripts/check_references.py +7 -6
- package/scripts/check_release_pr_shape.py +112 -0
- package/scripts/check_reply_consistency.py +3 -3
- package/scripts/check_safety_floor_untouched.py +1 -1
- package/scripts/check_template_pin_drift.py +5 -5
- package/scripts/check_token_optimizer_freshness.py +3 -3
- package/scripts/ci_status.py +301 -0
- package/scripts/ci_time_ratio.py +1 -1
- package/scripts/cleanup_other_scope.sh +146 -0
- package/scripts/compile_router.py +10 -10
- package/scripts/{compress.py → condense.py} +64 -64
- package/scripts/condense.sh +18 -0
- package/scripts/{compress_memory.py → condense_memory.py} +33 -33
- package/scripts/config/presets.py +2 -2
- package/scripts/config/profiles.py +1 -1
- package/scripts/cost_by_conversation.py +3 -3
- package/scripts/cost_summary.py +7 -7
- package/scripts/count_token_optimizer_usage.sh +1 -1
- package/scripts/gen_discovery_baseline.py +5 -5
- package/scripts/generate_index.py +6 -6
- package/scripts/generate_ownership_matrix.py +10 -10
- package/scripts/generate_pack_manifests.py +1 -1
- package/scripts/ghostwriter_fixture_allowlist.txt +1 -1
- package/scripts/install +3 -3
- package/scripts/install-hooks.sh +6 -6
- package/scripts/install.py +76 -11
- package/scripts/install.sh +187 -1
- package/scripts/inventory_frontmatter.py +2 -2
- package/scripts/iron_law_sha.py +3 -3
- package/scripts/lint_agents_layout.py +14 -7
- package/scripts/lint_agents_md.py +4 -4
- package/scripts/lint_archived_skills.py +3 -3
- package/scripts/lint_artefact_frontmatter.py +2 -2
- package/scripts/lint_bench_ab.py +172 -0
- package/scripts/lint_bench_corpus.py +1 -1
- package/scripts/lint_command_tiers.py +5 -5
- package/scripts/lint_context_spine_usage.py +1 -1
- package/scripts/lint_framework_leakage.py +7 -7
- package/scripts/lint_framework_leakage_allowlist.json +144 -84
- package/scripts/lint_ghostwriter_source.py +3 -3
- package/scripts/lint_handoffs.py +1 -1
- package/scripts/lint_load_context.py +11 -11
- package/scripts/lint_media_policy_linkage.py +5 -5
- package/scripts/lint_namespace.py +1 -1
- package/scripts/lint_no_new_atomic_commands.py +2 -2
- package/scripts/lint_orchestration_dsl.py +1 -1
- package/scripts/lint_pack_boundaries.py +2 -2
- package/scripts/lint_persona_governance.py +4 -4
- package/scripts/lint_role_experiences.py +237 -0
- package/scripts/lint_rule_interactions.py +2 -2
- package/scripts/lint_rule_tiers.py +1 -1
- package/scripts/lint_trust_coherence.py +2 -2
- package/scripts/mcp_registry_submit.sh +187 -0
- package/scripts/mcp_server/tools.py +1 -1
- package/scripts/measure_frugality_savings.py +10 -10
- package/scripts/measure_patterns.py +1 -1
- package/scripts/measure_projection_bytes.py +5 -5
- package/scripts/measure_rule_budget.py +3 -3
- package/scripts/measure_skill_reduction.py +1 -1
- package/scripts/memory_lookup.py +1 -1
- package/scripts/memory_status.py +2 -2
- package/scripts/migrate_command_suggestions.py +3 -3
- package/scripts/mine_session.py +1 -1
- package/scripts/move_artefact.py +3 -3
- package/scripts/new_skill.py +2 -2
- package/scripts/pack_mcp_content.py +9 -9
- package/scripts/plan_physical_move.py +6 -6
- package/scripts/print_required_checks.py +196 -0
- package/scripts/probe_skill_registration.py +413 -0
- package/scripts/propose_modules_config.py +145 -0
- package/scripts/prototype_lint_contradictions.py +1 -1
- package/scripts/recruit_preflight.sh +152 -0
- package/scripts/refine_ticket_detect.py +3 -3
- package/scripts/release.py +20 -0
- package/scripts/render_benchmark_md.py +308 -0
- package/scripts/roadmap_progress_hook.py +1 -1
- package/scripts/run_skill_evals.py +2 -2
- package/scripts/runtime_registry.py +4 -4
- package/scripts/schemas/command.schema.json +4 -4
- package/scripts/schemas/rule.schema.json +5 -5
- package/scripts/schemas/skill.schema.json +3 -3
- package/scripts/schemas/user-type.schema.json +1 -1
- package/scripts/score_skill_selection.py +1 -1
- package/scripts/skill_collision_clusters.py +2 -2
- package/scripts/skill_linter.py +81 -81
- package/scripts/skill_overlap.py +5 -5
- package/scripts/skill_tools/audit_persona_coverage.py +2 -2
- package/scripts/skill_tools/audit_user_type_coverage.py +2 -2
- package/scripts/skill_tools/run_block_d_eval.py +1 -1
- package/scripts/skill_tools/score_skill_relevance.py +1 -1
- package/scripts/skill_tools/suggest_skill_for_task.py +1 -1
- package/scripts/skill_trigger_eval.py +3 -3
- package/scripts/smoke/kernel.sh +7 -1
- package/scripts/smoke/router.sh +5 -5
- package/scripts/smoke/skills.sh +1 -1
- package/scripts/smoke_quickstart.py +1 -1
- package/scripts/snapshot_agent_outputs.py +3 -3
- package/scripts/spotcheck_thin_root.py +1 -1
- package/scripts/{caveman_stats.py → telegraph_stats.py} +18 -18
- package/scripts/update_counts.py +1 -1
- package/scripts/validate_decision_engine.py +1 -1
- package/scripts/validate_frontmatter.py +1 -1
- package/scripts/validate_safe_paths.py +3 -3
- package/scripts/{validate_caveman_carveouts.py → validate_telegraph_carveouts.py} +7 -7
- package/scripts/verify_roadmap_closure.py +6 -6
- package/templates/consumer-settings/ONBOARDING.md +41 -0
- package/.agent-src/commands/install-via-agent.md +0 -129
- package/.agent-src/skills/compress-memory/SKILL.md +0 -131
- package/dist/ui/assets/index-D-DY1ywI.js +0 -35
- package/dist/ui/assets/index-D-DY1ywI.js.map +0 -1
- package/dist/ui/assets/index-Dqfhmg-d.css +0 -1
- package/docs/adrs/caveman/README.md +0 -9
- package/docs/contracts/caveman-telemetry.md +0 -83
- package/scripts/compress.sh +0 -18
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Prompt Templates
|
|
2
2
|
|
|
3
|
-
Reference catalogue of prompt structures the [`prompt-optimizer`](../../.agent-src.
|
|
3
|
+
Reference catalogue of prompt structures the [`prompt-optimizer`](../../.agent-src.uncondensed/skills/prompt-optimizer/SKILL.md)
|
|
4
4
|
skill picks from during the **Develop** step of the 4-D methodology.
|
|
5
|
-
Cited by the [`refine-prompt`](../../.agent-src.
|
|
5
|
+
Cited by the [`refine-prompt`](../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
|
|
6
6
|
skill in `mini` mode for stack-aware shaping.
|
|
7
7
|
|
|
8
8
|
Templates are tools, not dogma. Pick by request type, not by upstream
|
|
@@ -108,7 +108,7 @@ warrants either reaction. The stance slot makes the honest-when-warranted
|
|
|
108
108
|
contract explicit.
|
|
109
109
|
|
|
110
110
|
**Package equivalents** — inside this agent-config, the
|
|
111
|
-
[`adversarial-review`](../../.agent-src.
|
|
111
|
+
[`adversarial-review`](../../.agent-src.uncondensed/skills/adversarial-review/SKILL.md)
|
|
112
112
|
skill implements the same stance via an Attack-Defend-Revise loop and is
|
|
113
113
|
the right tool when the user submits finished work for a critical take.
|
|
114
114
|
This template is for **end-users prompting their own LLM** (ChatGPT,
|
|
@@ -160,7 +160,7 @@ membership.
|
|
|
160
160
|
|
|
161
161
|
## See also
|
|
162
162
|
|
|
163
|
-
- [`prompt-optimizer`](../../.agent-src.
|
|
164
|
-
- [`refine-prompt`](../../.agent-src.
|
|
165
|
-
- [`prompt-engineering-patterns`](../../.agent-src.
|
|
163
|
+
- [`prompt-optimizer`](../../.agent-src.uncondensed/skills/prompt-optimizer/SKILL.md) — engine-outbound; cites this catalogue in its Develop step
|
|
164
|
+
- [`refine-prompt`](../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md) — engine-inbound; uses templates in `mini` mode for stack-aware shaping
|
|
165
|
+
- [`prompt-engineering-patterns`](../../.agent-src.uncondensed/skills/prompt-engineering-patterns/SKILL.md) — production-LLM prompt patterns (sibling skill, not a catalogue)
|
|
166
166
|
- AI Council session: `agents/runtime/council/responses/prompt-master-mini.json` (2026-05-17) <!-- council-ref-allowed: ADR decision trace -->
|
|
@@ -73,7 +73,7 @@ the flag is set outside the package repo.
|
|
|
73
73
|
- **Audit-visible.** Every install run logs whether the flag was set
|
|
74
74
|
at the top of the transaction log.
|
|
75
75
|
- **No silent fallback.** If `scripts/install.py` detects the
|
|
76
|
-
package repo signature (presence of `.agent-src.
|
|
76
|
+
package repo signature (presence of `.agent-src.uncondensed/` plus
|
|
77
77
|
`dist/router.json`) and the flag is **not** set, the install
|
|
78
78
|
refuses with a one-line error pointing here.
|
|
79
79
|
- **Not for consumers.** Setting the flag in a consumer project is
|
package/docs/mcp.md
CHANGED
|
@@ -138,7 +138,7 @@ secret tool you already use into the process environment before you run
|
|
|
138
138
|
|
|
139
139
|
## Related
|
|
140
140
|
|
|
141
|
-
- [`.agent-src.
|
|
141
|
+
- [`.agent-src.uncondensed/skills/mcp/SKILL.md`](../.agent-src.uncondensed/skills/mcp/SKILL.md) — MCP server
|
|
142
142
|
selection and usage patterns.
|
|
143
143
|
- [`agents/roadmaps/archive/road-to-mcp.md`](../agents/roadmaps/archive/road-to-mcp.md) — archived roadmap that produced this feature.
|
|
144
144
|
- Reference substitution implementation: [`kdcllc/agents_config`](https://github.com/kdcllc/agents_config/blob/master/app/agents_config/base.py).
|
package/docs/parity/bench.json
CHANGED
|
@@ -27,8 +27,8 @@
|
|
|
27
27
|
"projection_fidelity_windsurf": "not_applicable"
|
|
28
28
|
},
|
|
29
29
|
"decisions_pending": {
|
|
30
|
-
"
|
|
31
|
-
"kill_criterion": "docs/contracts/
|
|
30
|
+
"condensation_default": {
|
|
31
|
+
"kill_criterion": "docs/contracts/condensation-default-kill-criterion.md",
|
|
32
32
|
"verdict": "deferred_until_baseline_closes",
|
|
33
33
|
"decision_owner": "step-4 closeout phase"
|
|
34
34
|
}
|
|
@@ -36,6 +36,6 @@
|
|
|
36
36
|
"downstream_consumers": [
|
|
37
37
|
"agents/roadmaps/step-99-north-star-restructure.md#G1",
|
|
38
38
|
"agents/roadmaps/step-2-skill-inventory-rationalization.md#G0",
|
|
39
|
-
"docs/contracts/
|
|
39
|
+
"docs/contracts/condensation-default-kill-criterion.md"
|
|
40
40
|
]
|
|
41
41
|
}
|
package/docs/parity/ruflo.md
CHANGED
|
@@ -28,9 +28,9 @@ soak in [`bench.json`](bench.json) flips from `warmup` to `baseline_ready`
|
|
|
28
28
|
| 3 | **50/75/90/100 % budget ladder with hard stop** | `[x] covered by` | [`scripts/cost/budget.mjs`](../../scripts/cost/budget.mjs) — exit codes 0/1/2/3 per tier; opt-in fail-closed via `cost.enforcement` setting. Fixtures: `tests/fixtures/cost/budget/{under-50,at-100,over-100}/`. Step-11 Phase 2. |
|
|
29
29
|
| 4 | **Measured-vs-claimed disclaimer** — every percentage tagged "claimed upstream" | `[x] covered by` | One-line `**Measured-vs-claimed disclaimer:**` header block on all 9 active roadmaps in `agents/roadmaps/`. Verified 2026-05-16. Step-11 Phase 5 Step 4. |
|
|
30
30
|
| 5 | **Smoke test as contract** — `bash scripts/smoke.sh` with declared baseline | `[x] covered by` | Four per-tier smoke scripts: [`scripts/smoke/kernel.sh`](../../scripts/smoke/kernel.sh), [`router.sh`](../../scripts/smoke/router.sh), [`schema.sh`](../../scripts/smoke/schema.sh), [`skills.sh`](../../scripts/smoke/skills.sh). Declared baselines in [`docs/contracts/smoke-contracts.md`](../contracts/smoke-contracts.md). CI gate: [`.github/workflows/smoke.yml`](../../.github/workflows/smoke.yml). Step-11 Phase 3. |
|
|
31
|
-
| 6 | **Per-plugin ADR directory** — `docs/adrs/0001-*.md` co-located with subsystem | `[x] covered by` | Six bootstrap ADRs under [`docs/adrs/{cost,memory,router,schema,smoke,
|
|
31
|
+
| 6 | **Per-plugin ADR directory** — `docs/adrs/0001-*.md` co-located with subsystem | `[x] covered by` | Six bootstrap ADRs under [`docs/adrs/{cost,memory,router,schema,smoke,telegraph}/`](../adrs/). Coverage gate: [`scripts/audit_adr_coverage.py`](../../scripts/audit_adr_coverage.py) (`task lint-adr-coverage`). Contract: [`docs/contracts/adr-layout.md`](../contracts/adr-layout.md). Step-11 Phase 4. |
|
|
32
32
|
| 7 | **Namespace contract** — `<stem>-<intent>` kebab-case, reserved-names list | `[x] covered by` | [`scripts/lint_namespace.py`](../../scripts/lint_namespace.py) enforces shape + length floors + reserved-names + skill-dir-matches-name across 430 names · 0 issues. Contract: [`docs/contracts/namespace.md`](../contracts/namespace.md). CI gate: `task lint-namespace`. Step-11 Phase 5 Step 1. |
|
|
33
|
-
| 8 | **Topology choices in swarm** — `hierarchical / mesh / star / adaptive` with anti-drift defaults | `[x] covered by` | [`.agent-src.
|
|
33
|
+
| 8 | **Topology choices in swarm** — `hierarchical / mesh / star / adaptive` with anti-drift defaults | `[x] covered by` | [`.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md`](../../.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md) `Topology hints` subsection — 7-row table mapping each mode to topology + Ruflo anti-drift default (`hierarchical, 6–8 agents, raft consensus`). Step-11 Phase 5 Step 2. |
|
|
34
34
|
| 9 | **MCP-tool count + source-line refs** — every tool with `<file>:<line>` citation | `[x] covered by` | [`docs/contracts/mcp-tool-inventory.md`](../contracts/mcp-tool-inventory.md) — 20 tools (9 stdio-implemented · 11 discovery stubs) each with catalog `<file>:<line>` + handler `<file>:<line>`. Generator: [`scripts/audit_mcp_tools.py`](../../scripts/audit_mcp_tools.py). CI drift gate: `task lint-mcp-inventory`. Step-11 Phase 5 Step 3. |
|
|
35
35
|
|
|
36
36
|
## Open `[!]` rows
|
package/docs/profiles.md
CHANGED
|
@@ -4,7 +4,7 @@ Each block below is the first-screen for one shipped profile. The
|
|
|
4
4
|
`profile.id` written by `agent-config setup` selects the anchor; the block names
|
|
5
5
|
the audience, the first three things the agent does for that role,
|
|
6
6
|
and the exact commands and skills wired into the profile YAML at
|
|
7
|
-
[`.agent-src.
|
|
7
|
+
[`.agent-src.uncondensed/profiles/<id>.yml`](../.agent-src.uncondensed/profiles/).
|
|
8
8
|
|
|
9
9
|
The summary table at the top of [`README.md`](../README.md) is the
|
|
10
10
|
one-page index; the prose below is the deep version.
|
|
@@ -18,7 +18,7 @@ and verifies; `/work` is the free-form sibling; `/review-changes`
|
|
|
18
18
|
dispatches five judges (bug, security, tests, quality, architecture)
|
|
19
19
|
on the local diff. Stack-aware skills cover Laravel · Symfony ·
|
|
20
20
|
Next.js · React · Node. **Preset default: `balanced`.**
|
|
21
|
-
[Profile YAML](../.agent-src.
|
|
21
|
+
[Profile YAML](../.agent-src.uncondensed/profiles/developer.yml) ·
|
|
22
22
|
[Role guide](getting-started-by-role.md#developer-the-original-audience).
|
|
23
23
|
|
|
24
24
|
<a id="profile-content_creator"></a>
|
|
@@ -35,7 +35,7 @@ motion+audio prompt → provider render → stitched clip), with
|
|
|
35
35
|
`character-consistency` locking identity tokens across scenes and
|
|
36
36
|
`AIV_DRYRUN=true` as the cost-safety default.
|
|
37
37
|
**Preset default: `balanced`.**
|
|
38
|
-
[Profile YAML](../.agent-src.
|
|
38
|
+
[Profile YAML](../.agent-src.uncondensed/profiles/content_creator.yml) ·
|
|
39
39
|
[Role guide](getting-started-by-role.md#creator-writer-marketer-indie-content-shop).
|
|
40
40
|
|
|
41
41
|
<a id="profile-founder"></a>
|
|
@@ -47,7 +47,7 @@ into a copyable pitch; `/council` polls external AIs for a neutral
|
|
|
47
47
|
second opinion; `rice-prioritization` ranks the backlog;
|
|
48
48
|
`vision-articulation` and `fundraising-narrative` shape the
|
|
49
49
|
internal-vs-external story. **Preset default: `fast`.**
|
|
50
|
-
[Profile YAML](../.agent-src.
|
|
50
|
+
[Profile YAML](../.agent-src.uncondensed/profiles/founder.yml) ·
|
|
51
51
|
[Role guide](getting-started-by-role.md#founder-early-stage-operator-wearing-every-hat).
|
|
52
52
|
|
|
53
53
|
<a id="profile-agency"></a>
|
|
@@ -59,7 +59,7 @@ provenance. `/refine-ticket` rewrites the ticket and surfaces top-5
|
|
|
59
59
|
risks; `estimate-ticket` sizes and splits; `decision-record` anchors
|
|
60
60
|
the trade-off in an ADR before code starts. **Preset default:
|
|
61
61
|
`strict`.**
|
|
62
|
-
[Profile YAML](../.agent-src.
|
|
62
|
+
[Profile YAML](../.agent-src.uncondensed/profiles/agency.yml) ·
|
|
63
63
|
[Role guide](getting-started-by-role.md#consultant-advisory-freelance-fractional).
|
|
64
64
|
|
|
65
65
|
<a id="profile-finance"></a>
|
|
@@ -70,7 +70,7 @@ walks the WACC / terminal-value / 5-year-hold reasoning; `forecasting`
|
|
|
70
70
|
reconciles top-down vs bottom-up; `scenario-modeling` produces the
|
|
71
71
|
base / upside / downside cuts; `runway-cognition` frames the
|
|
72
72
|
fundraise-vs-cut-vs-grow decision. **Preset default: `strict`.**
|
|
73
|
-
[Profile YAML](../.agent-src.
|
|
73
|
+
[Profile YAML](../.agent-src.uncondensed/profiles/finance.yml) ·
|
|
74
74
|
[Role guide](getting-started-by-role.md#finance--ops-cfo-controller-ops-lead-founder-finance).
|
|
75
75
|
|
|
76
76
|
<a id="profile-ops"></a>
|
|
@@ -82,15 +82,15 @@ breaks, build the dashboard that catches it next time.
|
|
|
82
82
|
the first line of code; `incident-commander` frames severity and
|
|
83
83
|
post-mortem; `dashboard-design` chooses the right RED / USE / Golden
|
|
84
84
|
Signal panel. **Preset default: `strict`.**
|
|
85
|
-
[Profile YAML](../.agent-src.
|
|
85
|
+
[Profile YAML](../.agent-src.uncondensed/profiles/ops.yml) ·
|
|
86
86
|
[Role guide](getting-started-by-role.md#finance--ops-cfo-controller-ops-lead-founder-finance).
|
|
87
87
|
|
|
88
88
|
> **Universal AI Agent OS, not "for developers only".** The same
|
|
89
89
|
> orchestration core also drives non-software trades. Worked-example
|
|
90
|
-
> user types ship for [galabau](../.agent-src.
|
|
91
|
-
> [metalworking](../.agent-src.
|
|
92
|
-
> [truck driving](../.agent-src.
|
|
93
|
-
> with a [scaffold](../.agent-src.
|
|
90
|
+
> user types ship for [galabau](../.agent-src.uncondensed/user-types/galabau-field-crew.md),
|
|
91
|
+
> [metalworking](../.agent-src.uncondensed/user-types/metalworking-shop.md),
|
|
92
|
+
> [truck driving](../.agent-src.uncondensed/user-types/truck-driver.md) —
|
|
93
|
+
> with a [scaffold](../.agent-src.uncondensed/user-types/_template/) for
|
|
94
94
|
> contributing your own.
|
|
95
95
|
|
|
96
96
|
→ [Public catalog](catalog.md) (all rules, skills, commands, guidelines) · [Skills only](skills-catalog.md) · [llms.txt](../llms.txt)
|
package/docs/quality.md
CHANGED
|
@@ -10,8 +10,8 @@ task ci
|
|
|
10
10
|
|
|
11
11
|
This runs, in order:
|
|
12
12
|
|
|
13
|
-
1. **Sync check** — `.agent-src/` matches `.agent-src.
|
|
14
|
-
2. **
|
|
13
|
+
1. **Sync check** — `.agent-src/` matches `.agent-src.uncondensed/` (non-`.md` files)
|
|
14
|
+
2. **Condensation hashes** — Condensed `.md` hashes match source
|
|
15
15
|
3. **Reference check** — No broken cross-references between files
|
|
16
16
|
4. **Portability check** — No project-specific paths in shared files
|
|
17
17
|
5. **Schema validation** — Frontmatter of every skill/rule/command/persona matches its JSON-Schema contract
|
|
@@ -29,7 +29,7 @@ The linter (`scripts/skill_linter.py`) validates:
|
|
|
29
29
|
- **Required structure** — YAML frontmatter, description, triggers
|
|
30
30
|
- **Frontmatter schema** — Each artefact type has a JSON-Schema in `scripts/schemas/`; violations surface as `schema_<rule>` errors (see [frontmatter contract](../agents/reference/docs/frontmatter-contract.md))
|
|
31
31
|
- **Anti-patterns** — Procedural rules in behavior rules, overlong skills, scope creep
|
|
32
|
-
- **
|
|
32
|
+
- **Condensation quality** — Key sections preserved after condensation
|
|
33
33
|
|
|
34
34
|
Schema validation also runs standalone via `task validate-schema` — fast
|
|
35
35
|
fail before the full linter.
|
|
@@ -50,32 +50,32 @@ fail before the full linter.
|
|
|
50
50
|
|
|
51
51
|
---
|
|
52
52
|
|
|
53
|
-
##
|
|
53
|
+
## Condensation System
|
|
54
54
|
|
|
55
|
-
Content flows from verbose (`.agent-src.
|
|
55
|
+
Content flows from verbose (`.agent-src.uncondensed/`) to condensed (`.agent-src/`),
|
|
56
56
|
which is then projected into `.augment/` for Augment Code.
|
|
57
57
|
|
|
58
58
|
### Rules
|
|
59
59
|
|
|
60
|
-
- Source of truth is **always** `.agent-src.
|
|
60
|
+
- Source of truth is **always** `.agent-src.uncondensed/`
|
|
61
61
|
- Never edit `.agent-src/` or `.augment/` directly
|
|
62
|
-
- The `/
|
|
63
|
-
-
|
|
62
|
+
- The `/condense` command produces token-efficient output
|
|
63
|
+
- Condensation hashes track which files have been condensed
|
|
64
64
|
|
|
65
65
|
### Verification
|
|
66
66
|
|
|
67
67
|
```bash
|
|
68
68
|
task sync-check # Non-.md files in sync?
|
|
69
69
|
task sync-check-hashes # .md hashes current?
|
|
70
|
-
task check-
|
|
71
|
-
task lint-skills-pairs # Source vs
|
|
70
|
+
task check-condensation # Condensation quality OK?
|
|
71
|
+
task lint-skills-pairs # Source vs condensed comparison
|
|
72
72
|
```
|
|
73
73
|
|
|
74
74
|
### Fixing
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
77
|
task sync # Copy non-.md files
|
|
78
|
-
task sync-mark-all-done # Mark all hashes as current (after manual
|
|
78
|
+
task sync-mark-all-done # Mark all hashes as current (after manual condense)
|
|
79
79
|
task consistency-fix # Regenerate ALL derived outputs
|
|
80
80
|
```
|
|
81
81
|
|
package/docs/safety.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Data governance & domain safety
|
|
2
2
|
|
|
3
|
-
`agent-config` ships **12 domain-safety rules** (`.agent-src.
|
|
3
|
+
`agent-config` ships **12 domain-safety rules** (`.agent-src.uncondensed/rules/domain-safety-*.md`) that act as a per-domain output floor — PII redaction, disclaimer requirements, and retention guidance. Rules fire automatically via the router when their triggers match.
|
|
4
4
|
|
|
5
5
|
## Surface → rule(s) → floor
|
|
6
6
|
|
|
@@ -21,8 +21,8 @@
|
|
|
21
21
|
|
|
22
22
|
## Related skills
|
|
23
23
|
|
|
24
|
-
- [`privacy-review`](../.agent-src.
|
|
25
|
-
- [`data-handling-judgment`](../.agent-src.
|
|
24
|
+
- [`privacy-review`](../.agent-src.uncondensed/skills/privacy-review/SKILL.md) — end-to-end data-flow review for a regulatory regime (GDPR / CCPA / HIPAA).
|
|
25
|
+
- [`data-handling-judgment`](../.agent-src.uncondensed/skills/data-handling-judgment/SKILL.md) — classification, retention, cross-border transfer, DSR workflow.
|
|
26
26
|
|
|
27
27
|
## See also
|
|
28
28
|
|
|
@@ -33,7 +33,7 @@ look for MCP server config inside `.agent-settings.yml`.
|
|
|
33
33
|
| File | Where | Who reads it | Purpose |
|
|
34
34
|
|---|---|---|---|
|
|
35
35
|
| MCP client config (this page) | client-specific path per section above | the MCP client at startup | which MCP servers to talk to (name + URL / command) |
|
|
36
|
-
| `.agent-settings.yml` | consumer project root (`<repo>/.agent-settings.yml`) | the agent at runtime (Claude / Cursor / …) | per-developer preferences: `name`, `ide`, `cost_profile`, `personal.autonomy`, `pipelines.skill_improvement`, `
|
|
36
|
+
| `.agent-settings.yml` | consumer project root (`<repo>/.agent-settings.yml`) | the agent at runtime (Claude / Cursor / …) | per-developer preferences: `name`, `ide`, `cost_profile`, `personal.autonomy`, `pipelines.skill_improvement`, `telegraph.speak_scope`, … |
|
|
37
37
|
|
|
38
38
|
The Worker is **stateless** and **project-agnostic** — it serves the
|
|
39
39
|
same skill / rule / command catalog to every client. Personalization
|
|
@@ -20,7 +20,7 @@ agent-config-mcp/
|
|
|
20
20
|
├─ releases/
|
|
21
21
|
│ ├─ v<X.Y.Z>-<sha>/
|
|
22
22
|
│ │ ├─ content.json.gz # gzipped content blob (R2 archival copy)
|
|
23
|
-
│ │ └─ manifest.json #
|
|
23
|
+
│ │ └─ manifest.json # uncondensed manifest sidecar
|
|
24
24
|
│ └─ latest.txt # one-line: v<X.Y.Z>-<sha>
|
|
25
25
|
└─ (no other prefixes)
|
|
26
26
|
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# MCP server — Docker (stdio bundle)
|
|
2
2
|
|
|
3
|
-
Phase-6 F3 ships `docker/mcp-server/Dockerfile`: a stdio-only image of
|
|
3
|
+
Phase-6 F3 ships `internal/docker/mcp-server/Dockerfile`: a stdio-only image of
|
|
4
4
|
the agent-config MCP server, pinned to the same `mcp` + `PyYAML`
|
|
5
5
|
versions the test suite runs against. No HTTP / SSE transport — that
|
|
6
6
|
lives in [`road-to-mcp-distribution.md`](../../agents/roadmaps/road-to-mcp-distribution.md)
|
|
@@ -8,11 +8,11 @@ under its own A0 amendment.
|
|
|
8
8
|
|
|
9
9
|
## Build
|
|
10
10
|
|
|
11
|
-
Build context is the **repo root**, not `docker/mcp-server/` — the
|
|
11
|
+
Build context is the **repo root**, not `internal/docker/mcp-server/` — the
|
|
12
12
|
`COPY` lines reference paths relative to the project root.
|
|
13
13
|
|
|
14
14
|
```bash
|
|
15
|
-
docker build -f docker/mcp-server/Dockerfile -t agent-config-mcp:local .
|
|
15
|
+
docker build -f internal/docker/mcp-server/Dockerfile -t agent-config-mcp:local .
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
Tag conventions:
|
|
@@ -99,7 +99,7 @@ should match `ls .windsurf/workflows/`.
|
|
|
99
99
|
| Rules not picked up | Windsurf < 1.0 — upgrade or rely on `.windsurfrules`. |
|
|
100
100
|
| Workflow not in Cascade panel | Reload window after `task generate-tools`. |
|
|
101
101
|
| Global workflows missing | Check `~/.codeium/windsurf/global_workflows/` exists. |
|
|
102
|
-
| Frontmatter parse error | Re-run `python3 scripts/
|
|
102
|
+
| Frontmatter parse error | Re-run `python3 scripts/condense.py --generate-tools`. |
|
|
103
103
|
|
|
104
104
|
## Cross-references
|
|
105
105
|
|
package/docs/skills-catalog.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Skills Catalog
|
|
2
2
|
|
|
3
|
-
All **
|
|
3
|
+
All **219 skills** available in this package, in alphabetical order.
|
|
4
4
|
Click a skill name to open its SKILL.md and read the full guidance.
|
|
5
5
|
|
|
6
6
|
> **Regenerate:** `python3 scripts/generate_catalog.py`
|
|
@@ -36,12 +36,12 @@ Click a skill name to open its SKILL.md and read the full guidance.
|
|
|
36
36
|
| [`code-refactoring`](../.agent-src/skills/code-refactoring/SKILL.md) | Use when the user says 'refactor this', 'rename class', or 'move method'. Safely refactors code in any language — finds all callers, updates downstream dependencies, verifies via quality tools. |
|
|
37
37
|
| [`code-review`](../.agent-src/skills/code-review/SKILL.md) | Use when the user says "review this", "check my code", or wants feedback on changes. Reviews for correctness, quality, security, and coding standards. |
|
|
38
38
|
| [`command-routing`](../.agent-src/skills/command-routing/SKILL.md) | Use when the user invokes a slash command like /create-pr, /commit, /fix-ci, or pastes command file content — routes to the right command with context inference and GitHub API patterns. |
|
|
39
|
-
| [`command-writing`](../.agent-src/skills/command-writing/SKILL.md) | Use when creating or editing a slash command in .agent-src.
|
|
39
|
+
| [`command-writing`](../.agent-src/skills/command-writing/SKILL.md) | Use when creating or editing a slash command in .agent-src.uncondensed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'. |
|
|
40
40
|
| [`comp-banding`](../.agent-src/skills/comp-banding/SKILL.md) | Use when designing levels, comp bands, equity-vs-cash, geo adjustments, or raise vs promotion vs market correction. Triggers on 'set our comp bands', 'is this raise market'. |
|
|
41
41
|
| [`competitive-moat-analysis`](../.agent-src/skills/competitive-moat-analysis/SKILL.md) | Use when mapping competitors, naming defensibility, and finding white-space — moat reasoning, where-to-play, where-not-to-play. Triggers on 'who are we competing with', 'what's our moat'. |
|
|
42
42
|
| [`competitive-positioning`](../.agent-src/skills/competitive-positioning/SKILL.md) | Use when comparing this package to a peer / competitor — ours-vs-theirs verdict table, axis selection, adoption queue. Triggers on 'how do we compare to X', 'should we adopt their pattern'. |
|
|
43
43
|
| [`composer-packages`](../.agent-src/skills/composer-packages/SKILL.md) | Use when building or maintaining a Composer library — versioning, Laravel integration, autoloading, publishing to private registries — even when the user says 'release a new version'. |
|
|
44
|
-
| [`
|
|
44
|
+
| [`condense-memory`](../.agent-src/skills/condense-memory/SKILL.md) | Use when shrinking always-loaded memory files (AGENTS.md, CLAUDE.md, .cursorrules) via telegraph grammar — refuses sensitive paths, round-trips via .original.md backup. |
|
|
45
45
|
| [`content-funnel-design`](../.agent-src/skills/content-funnel-design/SKILL.md) | Use when mapping funnel-stage to content shape — conversion-pathway, content-as-system, leverage-point selection. Triggers on 'design our content funnel', 'why does mid-funnel leak'. |
|
|
46
46
|
| [`context-authoring`](../.agent-src/skills/context-authoring/SKILL.md) | Use when filling in knowledge-layer context files — auth-model, tenant-boundaries, data-sensitivity, deployment-order, observability — interactive walkthrough that turns templates into reviewer fuel. |
|
|
47
47
|
| [`context-document`](../.agent-src/skills/context-document/SKILL.md) | Use when the user says "create context", "document this area", or wants a structured snapshot of a codebase area for agent orientation. |
|
|
@@ -126,7 +126,8 @@ Click a skill name to open its SKILL.md and read the full guidance.
|
|
|
126
126
|
| [`messaging-architecture`](../.agent-src/skills/messaging-architecture/SKILL.md) | Use when shaping the primary message, supporting proofs, and audience-by-message matrix from a locked positioning frame — before any copy or launch beat. Triggers on 'tighten the message stack'. |
|
|
127
127
|
| [`migration-architect`](../.agent-src/skills/migration-architect/SKILL.md) | Use when shaping a non-trivial migration — rollout phases, dual-write windows, cutover sequencing, deprecation cycles — hands off to the framework-specific migration skill for DDL once locked. |
|
|
128
128
|
| [`mobile-e2e-strategy`](../.agent-src/skills/mobile-e2e-strategy/SKILL.md) | Use when picking a mobile E2E framework — Detox / Appium / Maestro / XCUITest / Espresso — or planning iOS Simulator / Android Emulator coverage in CI for RN, Expo, or native apps. |
|
|
129
|
-
| [`module-
|
|
129
|
+
| [`module-detect-on-the-fly`](../.agent-src/skills/module-detect-on-the-fly/SKILL.md) | Use when editing a file under a module-shaped path (`Modules/*`, `packages/*`, `apps/*`, `internal/*`) while `modules.enabled` is `false` — asks the user once whether to enable the config. |
|
|
130
|
+
| [`module-management`](../.agent-src/skills/module-management/SKILL.md) | Use when working within any module under `modules.root_paths` from `.agent-project-settings.yml` — Laravel HMVC, Symfony DDD-lite, Node monorepo, Python src/, Go internal/, or a custom path. |
|
|
130
131
|
| [`motion-choreographer`](../.agent-src/skills/motion-choreographer/SKILL.md) | Use when turning a locked still + blueprint into a provider-tuned motion prompt — camera, primary + secondary motion, physics, native-audio sync. Triggers 'motion prompt for Veo/Kling/Sora'. |
|
|
131
132
|
| [`multi-tenancy`](../.agent-src/skills/multi-tenancy/SKILL.md) | Use when working with the multi-tenant architecture — customer DB switching, FQDN routing, tenant isolation, or cross-tenant operations. |
|
|
132
133
|
| [`nextjs-patterns`](../.agent-src/skills/nextjs-patterns/SKILL.md) | Writes Next.js App Router code — Server Components, Server Actions, RSC boundaries, route handlers, caching, and streaming — matching framework conventions and project architecture. |
|
|
@@ -140,7 +141,7 @@ Click a skill name to open its SKILL.md and read the full guidance.
|
|
|
140
141
|
| [`perf-feedback-craft`](../.agent-src/skills/perf-feedback-craft/SKILL.md) | Use when shaping feedback — situation-behavior-impact, growth-vs-corrective split, cadence design, ladder-of-inference checks. Triggers on 'how do I give this feedback', 'perf review shape'. |
|
|
141
142
|
| [`performance`](../.agent-src/skills/performance/SKILL.md) | Use when optimizing application performance — caching strategies, eager loading, query optimization, Redis patterns, or background job design. |
|
|
142
143
|
| [`performance-analysis`](../.agent-src/skills/performance-analysis/SKILL.md) | ONLY when user explicitly requests: performance audit, bottleneck analysis, or N+1 query detection. NOT for regular feature work. |
|
|
143
|
-
| [`persona-writing`](../.agent-src/skills/persona-writing/SKILL.md) | Use when creating or editing a persona in .agent-src.
|
|
144
|
+
| [`persona-writing`](../.agent-src/skills/persona-writing/SKILL.md) | Use when creating or editing a persona in .agent-src.uncondensed/personas/ — voice / focus / unique questions / output expectations — even when the user just says 'add a reviewer voice for X'. |
|
|
144
145
|
| [`pest-testing`](../.agent-src/skills/pest-testing/SKILL.md) | Use when writing, generating, or improving Pest tests for Laravel — clear intent, good coverage, maintainable structure, and alignment with project testing conventions. |
|
|
145
146
|
| [`php-coder`](../.agent-src/skills/php-coder/SKILL.md) | Writes or edits PHP code — controllers, classes, type hints, SOLID refactors, modern idioms — even without naming PHP. NOT for writing tests (use pest-testing) or explaining PHP concepts. |
|
|
146
147
|
| [`php-debugging`](../.agent-src/skills/php-debugging/SKILL.md) | Use when debugging PHP with Xdebug — breakpoints, step-through, dual-container setup, IDE configuration, header-based routing — even when the user just says 'why does this blow up on request X'. |
|
|
@@ -184,7 +185,7 @@ Click a skill name to open its SKILL.md and read the full guidance.
|
|
|
184
185
|
| [`roadmap-writing`](../.agent-src/skills/roadmap-writing/SKILL.md) | 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'. |
|
|
185
186
|
| [`rtk-output-filtering`](../.agent-src/skills/rtk-output-filtering/SKILL.md) | Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer) for 60-90% token savings. Covers installation, configuration, and usage patterns. |
|
|
186
187
|
| [`rule-refactor`](../.agent-src/skills/rule-refactor/SKILL.md) | 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. |
|
|
187
|
-
| [`rule-writing`](../.agent-src/skills/rule-writing/SKILL.md) | Use when creating or editing a rule in .agent-src.
|
|
188
|
+
| [`rule-writing`](../.agent-src/skills/rule-writing/SKILL.md) | Use when creating or editing a rule in .agent-src.uncondensed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'. |
|
|
188
189
|
| [`runway-cognition`](../.agent-src/skills/runway-cognition/SKILL.md) | Use when reasoning about cash runway — burn shape, fundraise triggers, layoff-vs-cut-vs-grow decisions. Triggers on 'how long do we have', 'should we raise', 'cut or grow'. |
|
|
189
190
|
| [`scenario-modeling`](../.agent-src/skills/scenario-modeling/SKILL.md) | Use when constructing base / upside / downside scenarios — three-statement modeling, sensitivity analysis, optionality reasoning. Triggers on 'model the scenarios', 'what if growth halves'. |
|
|
190
191
|
| [`scene-expander`](../.agent-src/skills/scene-expander/SKILL.md) | Use when expanding a one-line idea into the 12-block Cinematic Scene Blueprint — provider-agnostic, includes optional dialogue + ambient. Triggers 'expand this scene', 'blueprint for X'. |
|
|
@@ -195,7 +196,7 @@ Click a skill name to open its SKILL.md and read the full guidance.
|
|
|
195
196
|
| [`sentry-integration`](../.agent-src/skills/sentry-integration/SKILL.md) | Use when the user shares a Sentry URL, says "check Sentry", or wants to investigate production errors. Uses Sentry MCP tools for deep analysis. |
|
|
196
197
|
| [`sequential-thinking`](../.agent-src/skills/sequential-thinking/SKILL.md) | ONLY when user explicitly requests: step-by-step reasoning, structured problem decomposition, or iterative analysis. NOT for regular coding tasks. |
|
|
197
198
|
| [`skill-improvement-pipeline`](../.agent-src/skills/skill-improvement-pipeline/SKILL.md) | ONLY when user explicitly requests: run the skill improvement pipeline after a learning was detected. Orchestrates capture, classify, create, validate, and apply. |
|
|
198
|
-
| [`skill-management`](../.agent-src/skills/skill-management/SKILL.md) | Use when
|
|
199
|
+
| [`skill-management`](../.agent-src/skills/skill-management/SKILL.md) | Use when condensing, decondenseing, refactoring, or improving existing skills. Covers the full skill lifecycle from verbose → sharp → maintained. |
|
|
199
200
|
| [`skill-reviewer`](../.agent-src/skills/skill-reviewer/SKILL.md) | Use when reviewing, auditing, or optimizing skills — validates against the 7 Skill Killers checklist and produces fix recommendations. |
|
|
200
201
|
| [`skill-writing`](../.agent-src/skills/skill-writing/SKILL.md) | Use when deciding 'should this be a skill or a rule?', creating/improving/reviewing agent skills, SKILL.md frontmatter, or procedure sections — even without saying 'skill-writing'. |
|
|
201
202
|
| [`sql-writing`](../.agent-src/skills/sql-writing/SKILL.md) | Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement` — even when the user just pastes a query and asks 'why is this slow' without naming SQL. |
|
package/docs/troubleshooting.md
CHANGED
|
@@ -121,7 +121,7 @@ The bridge installer is Python-based and needs Python 3.8+ on PATH.
|
|
|
121
121
|
or from the Microsoft Store; ensure "Add python.exe to PATH" is
|
|
122
122
|
checked.
|
|
123
123
|
|
|
124
|
-
The portability check,
|
|
124
|
+
The portability check, condensation pipeline, and test suite also depend
|
|
125
125
|
on Python 3 — it is required for contributors, not just consumers.
|
|
126
126
|
|
|
127
127
|
---
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
stability: beta
|
|
3
|
+
keep-beta-until: 2026-08-26
|
|
4
|
+
roadmap_ref: road-to-frictionless-employee-workspace.md
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Daily Workspace — Accessibility Audit (WCAG 2.2 AA)
|
|
8
|
+
|
|
9
|
+
Audit pass for `src/ui/pages/WorkspacePage.tsx` against WCAG 2.2 AA.
|
|
10
|
+
Run-date: 2026-05-26. Owner: maintainer.
|
|
11
|
+
|
|
12
|
+
## Methodology
|
|
13
|
+
|
|
14
|
+
This audit is **static + automated** because the package ships no
|
|
15
|
+
browser-based E2E harness; Playwright's `request` fixture is the only
|
|
16
|
+
runtime path. The audit therefore combines:
|
|
17
|
+
|
|
18
|
+
- Static read of `WorkspacePage.tsx`, `app.css` Workspace block,
|
|
19
|
+
`tokens.css`, and the existing role / session fixtures.
|
|
20
|
+
- Vitest assertions: every interactive element carries an
|
|
21
|
+
`aria-label` or accessible name, every form control sits inside a
|
|
22
|
+
`<fieldset>` + `<legend>`, every list uses semantic `<ul>` / `<ol>`,
|
|
23
|
+
every region carries an `aria-labelledby` heading.
|
|
24
|
+
- Token-level contrast checks against `tokens.css` (light + dark
|
|
25
|
+
themes inherit the same Workspace classes).
|
|
26
|
+
|
|
27
|
+
Live keyboard-driven and screen-reader passes will land when the
|
|
28
|
+
package adds a browser-driver harness (deferred). The waivers below
|
|
29
|
+
document gaps to address when that harness lands.
|
|
30
|
+
|
|
31
|
+
## Checklist — passes
|
|
32
|
+
|
|
33
|
+
| WCAG ref | Criterion | Status | Evidence |
|
|
34
|
+
|---|---|---|---|
|
|
35
|
+
| 1.1.1 | Non-text content has text alternatives | Pass | Every action is text-labelled (`Start session`, `Pick role …`); no icons-only buttons. |
|
|
36
|
+
| 1.3.1 | Info and relationships are programmatically determinable | Pass | `<section aria-labelledby="…">` × 5 regions; `<fieldset>` + `<legend>` on the toggle. |
|
|
37
|
+
| 1.3.2 | Meaningful sequence | Pass | Source order = visual order: roles → tasks → sessions → knowledge → docs → explain. |
|
|
38
|
+
| 1.4.3 | Contrast (minimum) AA | Pass — see [`Contrast`](#contrast) | Inherits `tokens.css` neutral palette; non-text colour hints carry a text label too. |
|
|
39
|
+
| 1.4.10 | Reflow | Pass | `@media (max-width: 900px)` collapses the three-column grid to a single column. |
|
|
40
|
+
| 2.1.1 | Keyboard | Pass | All interactive controls are native `<button>` / `<a>` / `<input>` — no `onClick`-only `<div>`. |
|
|
41
|
+
| 2.4.6 | Headings and labels | Pass | One `<h1>`; each rail section starts with an `<h2>` carrying a stable id. |
|
|
42
|
+
| 2.4.7 | Focus visible | Pass | `:focus-visible` outline on `.ac-workspace__role`; tokens-driven `--color-primary` ring. |
|
|
43
|
+
| 3.2.1 | On focus | Pass | Focus changes never trigger a context change; selection commits only on click / Enter. |
|
|
44
|
+
| 3.3.2 | Labels or instructions | Pass | Toggle has both `aria-label` and visible legend; task buttons carry verb-phrase labels. |
|
|
45
|
+
| 4.1.2 | Name, role, value | Pass | All controls are native; `role`-grid uses `<button>` not `<div role="button">`. |
|
|
46
|
+
|
|
47
|
+
## Contrast
|
|
48
|
+
|
|
49
|
+
Spot-check against `:root` tokens (`tokens.css`):
|
|
50
|
+
|
|
51
|
+
- `--color-text` (#27272a) on `--color-surface` (#ffffff) → 14.4:1 → AA + AAA pass.
|
|
52
|
+
- `--color-text-muted` (#71717a) on `--color-surface` (#ffffff) → 4.85:1 → AA pass for body text.
|
|
53
|
+
- `.ac-workspace__role-status[data-status="beta"]` uses `--color-warn`
|
|
54
|
+
(#b45309) on white → 4.59:1 → AA pass.
|
|
55
|
+
- `.ac-workspace__role-status[data-status="stable"]` uses
|
|
56
|
+
`--color-success` (#15803d) on white → 5.05:1 → AA pass.
|
|
57
|
+
|
|
58
|
+
Dark theme (data-theme="dark") inherits the same Workspace classes
|
|
59
|
+
and overrides the surface / text tokens in `tokens.css`; the same
|
|
60
|
+
ratios apply by construction (the audit pass relies on the tokens
|
|
61
|
+
contract).
|
|
62
|
+
|
|
63
|
+
## Waivers — to address when a browser-driver harness lands
|
|
64
|
+
|
|
65
|
+
| Item | Reason | Re-audit trigger |
|
|
66
|
+
|---|---|---|
|
|
67
|
+
| Live screen-reader walkthrough (NVDA + VoiceOver) | No browser-driver harness in CI; static audit substitutes. | Add VoiceOver / NVDA pass when browser harness lands. |
|
|
68
|
+
| Keyboard-only navigation full pass | Same as above; vitest covers the toggle's reactive contract but not the page-wide tab order. | Browser harness pass. |
|
|
69
|
+
| Live colour-contrast check on the rendered DOM | Vite token compile is asserted only by source-token math. | Browser harness pass. |
|
|
70
|
+
| WCAG 2.2 SC 2.5.7 Dragging Movements | Not applicable — no drag-and-drop in v0. | Re-evaluate when document drag-to-rail lands. |
|
|
71
|
+
|
|
72
|
+
## Re-audit cadence
|
|
73
|
+
|
|
74
|
+
Re-audit on each of:
|
|
75
|
+
- Any new interactive control added to `WorkspacePage.tsx` or its
|
|
76
|
+
child components.
|
|
77
|
+
- Token-palette change in `tokens.css`.
|
|
78
|
+
- New role status badge (introduces a new `data-status` colour).
|
|
79
|
+
- WCAG version bump to 3.0 — currently 2.2 AA.
|
|
80
|
+
|
|
81
|
+
## See also
|
|
82
|
+
|
|
83
|
+
- `docs/contracts/daily-workspace.md` — surface contract.
|
|
84
|
+
- [`ADR-024`](../decisions/ADR-024-workspace-v0-feature-floor.md) — v0 floor.
|
|
85
|
+
- [`ADR-025`](../decisions/ADR-025-workspace-chrome.md) — chrome substrate.
|
|
86
|
+
- `tests/ui/WorkspaceExplainToggle.test.tsx` — toggle a11y assertions.
|
|
87
|
+
- `tests/e2e/workspace-launcher.spec.ts` — three-flow API E2E.
|
package/llms.txt
CHANGED
|
@@ -34,12 +34,12 @@ churn-prevention: Use when designing churn defence — health-score signals, chu
|
|
|
34
34
|
code-refactoring: Use when the user says 'refactor this', 'rename class', or 'move method'. Safely refactors code in any language — finds all callers, updates downstream dependencies, verifies via quality tools.
|
|
35
35
|
code-review: Use when the user says "review this", "check my code", or wants feedback on changes. Reviews for correctness, quality, security, and coding standards.
|
|
36
36
|
command-routing: Use when the user invokes a slash command like /create-pr, /commit, /fix-ci, or pastes command file content — routes to the right command with context inference and GitHub API patterns.
|
|
37
|
-
command-writing: Use when creating or editing a slash command in .agent-src.
|
|
37
|
+
command-writing: Use when creating or editing a slash command in .agent-src.uncondensed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'.
|
|
38
38
|
comp-banding: Use when designing levels, comp bands, equity-vs-cash, geo adjustments, or raise vs promotion vs market correction. Triggers on 'set our comp bands', 'is this raise market'.
|
|
39
39
|
competitive-moat-analysis: Use when mapping competitors, naming defensibility, and finding white-space — moat reasoning, where-to-play, where-not-to-play. Triggers on 'who are we competing with', 'what's our moat'.
|
|
40
40
|
competitive-positioning: Use when comparing this package to a peer / competitor — ours-vs-theirs verdict table, axis selection, adoption queue. Triggers on 'how do we compare to X', 'should we adopt their pattern'.
|
|
41
41
|
composer-packages: Use when building or maintaining a Composer library — versioning, Laravel integration, autoloading, publishing to private registries — even when the user says 'release a new version'.
|
|
42
|
-
|
|
42
|
+
condense-memory: Use when shrinking always-loaded memory files (AGENTS.md, CLAUDE.md, .cursorrules) via telegraph grammar — refuses sensitive paths, round-trips via .original.md backup.
|
|
43
43
|
content-funnel-design: Use when mapping funnel-stage to content shape — conversion-pathway, content-as-system, leverage-point selection. Triggers on 'design our content funnel', 'why does mid-funnel leak'.
|
|
44
44
|
context-authoring: Use when filling in knowledge-layer context files — auth-model, tenant-boundaries, data-sensitivity, deployment-order, observability — interactive walkthrough that turns templates into reviewer fuel.
|
|
45
45
|
context-document: Use when the user says "create context", "document this area", or wants a structured snapshot of a codebase area for agent orientation.
|
|
@@ -124,7 +124,8 @@ merge-conflicts: Use when the user has merge conflicts or says "resolve conflict
|
|
|
124
124
|
messaging-architecture: Use when shaping the primary message, supporting proofs, and audience-by-message matrix from a locked positioning frame — before any copy or launch beat. Triggers on 'tighten the message stack'.
|
|
125
125
|
migration-architect: Use when shaping a non-trivial migration — rollout phases, dual-write windows, cutover sequencing, deprecation cycles — hands off to the framework-specific migration skill for DDL once locked.
|
|
126
126
|
mobile-e2e-strategy: Use when picking a mobile E2E framework — Detox / Appium / Maestro / XCUITest / Espresso — or planning iOS Simulator / Android Emulator coverage in CI for RN, Expo, or native apps.
|
|
127
|
-
module-
|
|
127
|
+
module-detect-on-the-fly: Use when editing a file under a module-shaped path (`Modules/*`, `packages/*`, `apps/*`, `internal/*`) while `modules.enabled` is `false` — asks the user once whether to enable the config.
|
|
128
|
+
module-management: Use when working within any module under `modules.root_paths` from `.agent-project-settings.yml` — Laravel HMVC, Symfony DDD-lite, Node monorepo, Python src/, Go internal/, or a custom path.
|
|
128
129
|
motion-choreographer: Use when turning a locked still + blueprint into a provider-tuned motion prompt — camera, primary + secondary motion, physics, native-audio sync. Triggers 'motion prompt for Veo/Kling/Sora'.
|
|
129
130
|
multi-tenancy: Use when working with the multi-tenant architecture — customer DB switching, FQDN routing, tenant isolation, or cross-tenant operations.
|
|
130
131
|
nextjs-patterns: Writes Next.js App Router code — Server Components, Server Actions, RSC boundaries, route handlers, caching, and streaming — matching framework conventions and project architecture.
|
|
@@ -138,7 +139,7 @@ override-management: Creates and manages project-level overrides for shared skil
|
|
|
138
139
|
perf-feedback-craft: Use when shaping feedback — situation-behavior-impact, growth-vs-corrective split, cadence design, ladder-of-inference checks. Triggers on 'how do I give this feedback', 'perf review shape'.
|
|
139
140
|
performance: Use when optimizing application performance — caching strategies, eager loading, query optimization, Redis patterns, or background job design.
|
|
140
141
|
performance-analysis: ONLY when user explicitly requests: performance audit, bottleneck analysis, or N+1 query detection. NOT for regular feature work.
|
|
141
|
-
persona-writing: Use when creating or editing a persona in .agent-src.
|
|
142
|
+
persona-writing: Use when creating or editing a persona in .agent-src.uncondensed/personas/ — voice / focus / unique questions / output expectations — even when the user just says 'add a reviewer voice for X'.
|
|
142
143
|
pest-testing: Use when writing, generating, or improving Pest tests for Laravel — clear intent, good coverage, maintainable structure, and alignment with project testing conventions.
|
|
143
144
|
php-coder: Writes or edits PHP code — controllers, classes, type hints, SOLID refactors, modern idioms — even without naming PHP. NOT for writing tests (use pest-testing) or explaining PHP concepts.
|
|
144
145
|
php-debugging: Use when debugging PHP with Xdebug — breakpoints, step-through, dual-container setup, IDE configuration, header-based routing — even when the user just says 'why does this blow up on request X'.
|
|
@@ -182,7 +183,7 @@ roadmap-management: Use when the user says "create roadmap", "show roadmap", or
|
|
|
182
183
|
roadmap-writing: 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'.
|
|
183
184
|
rtk-output-filtering: Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer) for 60-90% token savings. Covers installation, configuration, and usage patterns.
|
|
184
185
|
rule-refactor: 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.
|
|
185
|
-
rule-writing: Use when creating or editing a rule in .agent-src.
|
|
186
|
+
rule-writing: Use when creating or editing a rule in .agent-src.uncondensed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'.
|
|
186
187
|
runway-cognition: Use when reasoning about cash runway — burn shape, fundraise triggers, layoff-vs-cut-vs-grow decisions. Triggers on 'how long do we have', 'should we raise', 'cut or grow'.
|
|
187
188
|
scenario-modeling: Use when constructing base / upside / downside scenarios — three-statement modeling, sensitivity analysis, optionality reasoning. Triggers on 'model the scenarios', 'what if growth halves'.
|
|
188
189
|
scene-expander: Use when expanding a one-line idea into the 12-block Cinematic Scene Blueprint — provider-agnostic, includes optional dialogue + ambient. Triggers 'expand this scene', 'blueprint for X'.
|
|
@@ -193,7 +194,7 @@ security-audit: ONLY when user explicitly requests: security audit, vulnerabilit
|
|
|
193
194
|
sentry-integration: Use when the user shares a Sentry URL, says "check Sentry", or wants to investigate production errors. Uses Sentry MCP tools for deep analysis.
|
|
194
195
|
sequential-thinking: ONLY when user explicitly requests: step-by-step reasoning, structured problem decomposition, or iterative analysis. NOT for regular coding tasks.
|
|
195
196
|
skill-improvement-pipeline: ONLY when user explicitly requests: run the skill improvement pipeline after a learning was detected. Orchestrates capture, classify, create, validate, and apply.
|
|
196
|
-
skill-management: Use when
|
|
197
|
+
skill-management: Use when condensing, decondenseing, refactoring, or improving existing skills. Covers the full skill lifecycle from verbose → sharp → maintained.
|
|
197
198
|
skill-reviewer: Use when reviewing, auditing, or optimizing skills — validates against the 7 Skill Killers checklist and produces fix recommendations.
|
|
198
199
|
skill-writing: Use when deciding 'should this be a skill or a rule?', creating/improving/reviewing agent skills, SKILL.md frontmatter, or procedure sections — even without saying 'skill-writing'.
|
|
199
200
|
sql-writing: Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement` — even when the user just pastes a query and asks 'why is this slow' without naming SQL.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@event4u/agent-config",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "4.1.0",
|
|
4
4
|
"description": "Universal AI Agent OS \u2014 audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"private": false,
|
|
Binary file
|
|
@@ -21,8 +21,8 @@ Phase 1 Step 3, addressing audit finding F3 / council finding C3 from
|
|
|
21
21
|
|---|---|---|
|
|
22
22
|
| [`_backfill_skill_domains.py`](_backfill_skill_domains.py) | B3 domain back-fill | Injected `domain:` frontmatter into every `SKILL.md`. Source of truth now lives in each skill's frontmatter directly. |
|
|
23
23
|
| [`_bootstrap_tier_frontmatter.py`](_bootstrap_tier_frontmatter.py) | Tier-frontmatter bootstrap | Injected `tier: N` frontmatter into every slash command during the kernel / tier-1 / tier-2 routing introduction. |
|
|
24
|
-
| [`_p43_bodies.py`](_p43_bodies.py) | Phase 4.3 — rule-body
|
|
25
|
-
| [`
|
|
24
|
+
| [`_p43_bodies.py`](_p43_bodies.py) | Phase 4.3 — rule-body condensation | Wrote condensed rule bodies after `_p43_condense.py` produced the manifest. Paired with `_p43_condense.py`. |
|
|
25
|
+
| [`_p43_condense.py`](_p43_condense.py) | Phase 4.3 — rule-body condensation | Surgical condensation of 22 `condense-and-keep` auto-rules; produced the manifest consumed by `_p43_bodies.py`. |
|
|
26
26
|
| [`_p4_migrate.py`](_p4_migrate.py) | Phase 4.1 + 4.2 — rule reclassification | Migrated rules into the skill / guideline / command / contract-stub split that the package ships today. |
|
|
27
27
|
| [`_phase2_shim_helper.py`](_phase2_shim_helper.py) | Phase 2 — deprecation shim | One-shot helper that injected `superseded_by:` + `deprecated_in:` + deprecation warning into rules retired during Phase 2. |
|
|
28
28
|
| [`_pilot_council_question.py`](_pilot_council_question.py) | Phase 1 pilot — kernel-membership council prep | Built the Phase-1 council question file used for the kernel-membership R1/R2 cross-check. The resulting council artefacts live under `agents/runtime/council/sessions/20260506T*`. |
|
|
@@ -93,10 +93,10 @@ VALID_DOMAINS = {"engineering", "product", "quality", "devops", "process", "disc
|
|
|
93
93
|
|
|
94
94
|
|
|
95
95
|
def main() -> int:
|
|
96
|
-
# Default: source-of-truth tree. Pass --target=
|
|
97
|
-
target = ".agent-src.
|
|
96
|
+
# Default: source-of-truth tree. Pass --target=condensed to mirror into .agent-src/.
|
|
97
|
+
target = ".agent-src.uncondensed/skills"
|
|
98
98
|
for arg in sys.argv[1:]:
|
|
99
|
-
if arg == "--target=
|
|
99
|
+
if arg == "--target=condensed":
|
|
100
100
|
target = ".agent-src/skills"
|
|
101
101
|
skills_root = Path(target)
|
|
102
102
|
on_disk = sorted(p.name for p in skills_root.iterdir() if p.is_dir())
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
Per Phase 4 Step 3 of `agents/roadmaps/road-to-distribution-maturity.md`.
|
|
5
5
|
|
|
6
|
-
Walks `.agent-src.
|
|
6
|
+
Walks `.agent-src.uncondensed/commands/**.md`. For each file:
|
|
7
7
|
|
|
8
8
|
- Tier-0 promotions match TIER_0 below — typed by hand.
|
|
9
9
|
- Tier-1 promotions match TIER_1 below — typed by hand.
|
|
@@ -21,7 +21,7 @@ from pathlib import Path
|
|
|
21
21
|
|
|
22
22
|
REPO_ROOT = Path(__file__).resolve().parent.parent
|
|
23
23
|
COMMANDS_DIRS = (
|
|
24
|
-
REPO_ROOT / ".agent-src.
|
|
24
|
+
REPO_ROOT / ".agent-src.uncondensed" / "commands",
|
|
25
25
|
REPO_ROOT / ".agent-src" / "commands",
|
|
26
26
|
)
|
|
27
27
|
|
|
@@ -57,7 +57,7 @@ TIER_1 = {
|
|
|
57
57
|
"bug-fix.md",
|
|
58
58
|
"bug-investigate.md",
|
|
59
59
|
"jira-ticket.md",
|
|
60
|
-
"
|
|
60
|
+
"condense.md",
|
|
61
61
|
"mode.md",
|
|
62
62
|
"project-analyze.md",
|
|
63
63
|
"project-health.md",
|