@event4u/agent-config 14.23.0 → 15.0.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/.augment-plugin/marketplace.json +3 -3
- package/.augment-plugin/plugin.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +198 -0
- package/README.md +1 -1
- package/dist/agent-src/commands/agent-handoff.md +8 -7
- package/dist/agent-src/commands/agents/init.md +1 -1
- package/dist/agent-src/commands/agents/user/accept.md +4 -4
- package/dist/agent-src/commands/agents/user/delete.md +2 -2
- package/dist/agent-src/commands/agents/user/init.md +3 -3
- package/dist/agent-src/commands/agents/user/review.md +3 -3
- package/dist/agent-src/commands/agents/user/show.md +3 -3
- package/dist/agent-src/commands/agents/user/update.md +2 -2
- package/dist/agent-src/commands/agents/user.md +6 -6
- package/dist/agent-src/commands/analytics/prune.md +1 -1
- package/dist/agent-src/commands/analytics/show.md +2 -2
- package/dist/agent-src/commands/analyze/decision.md +2 -2
- package/dist/agent-src/commands/analyze/inbox.md +5 -5
- package/dist/agent-src/commands/analyze/incident.md +3 -3
- package/dist/agent-src/commands/analyze/near-miss.md +3 -3
- package/dist/agent-src/commands/analyze/postmortem.md +4 -4
- package/dist/agent-src/commands/analyze/premortem.md +2 -2
- package/dist/agent-src/commands/analyze.md +2 -2
- package/dist/agent-src/commands/bug/fix.md +1 -1
- package/dist/agent-src/commands/bug/investigate.md +2 -2
- package/dist/agent-src/commands/cost/profile.md +3 -3
- package/dist/agent-src/commands/design.md +1 -1
- package/dist/agent-src/commands/feature/explore.md +1 -1
- package/dist/agent-src/commands/feature/plan.md +2 -2
- package/dist/agent-src/commands/feature/roadmap.md +2 -2
- package/dist/agent-src/commands/ghostwriter/fetch.md +4 -4
- package/dist/agent-src/commands/ghostwriter/list.md +1 -1
- package/dist/agent-src/commands/ghostwriter/show.md +1 -1
- package/dist/agent-src/commands/ghostwriter/write.md +9 -9
- package/dist/agent-src/commands/humanize.md +6 -6
- package/dist/agent-src/commands/jira-ticket.md +1 -1
- package/dist/agent-src/commands/judge/solo.md +1 -1
- package/dist/agent-src/commands/judge.md +1 -1
- package/dist/agent-src/commands/knowledge/cross-repo.md +1 -1
- package/dist/agent-src/commands/knowledge/forget.md +1 -1
- package/dist/agent-src/commands/knowledge/ingest.md +2 -2
- package/dist/agent-src/commands/knowledge/list.md +1 -1
- package/dist/agent-src/commands/memory/add.md +3 -3
- package/dist/agent-src/commands/memory/load.md +4 -4
- package/dist/agent-src/commands/memory/mine-session.md +1 -1
- package/dist/agent-src/commands/memory/promote.md +4 -4
- package/dist/agent-src/commands/memory/propose.md +2 -2
- package/dist/agent-src/commands/mode.md +5 -5
- package/dist/agent-src/commands/post-as/ghostwriter.md +3 -3
- package/dist/agent-src/commands/post-as/me.md +7 -7
- package/dist/agent-src/commands/pr/create.md +1 -1
- package/dist/agent-src/commands/pr/merge.md +1 -1
- package/dist/agent-src/commands/profile/activate.md +1 -1
- package/dist/agent-src/commands/profile/show.md +1 -1
- package/dist/agent-src/commands/research/deep.md +2 -2
- package/dist/agent-src/commands/research/report.md +2 -2
- package/dist/agent-src/commands/review/changes.md +1 -1
- package/dist/agent-src/commands/review/routing.md +1 -1
- package/dist/agent-src/commands/roadmap/create.md +1 -1
- package/dist/agent-src/commands/roadmap/materialize.md +2 -2
- package/dist/agent-src/commands/roadmap/next.md +1 -1
- package/dist/agent-src/commands/roadmap/process-full.md +2 -2
- package/dist/agent-src/commands/security-audit-config.md +3 -3
- package/dist/agent-src/commands/skill/preview.md +1 -1
- package/dist/agent-src/commands/skills/discover.md +1 -1
- package/dist/agent-src/commands/sync/agent-settings.md +2 -2
- package/dist/agent-src/commands/sync/gitignore/fix.md +1 -1
- package/dist/agent-src/commands/tests/create.md +1 -1
- package/dist/agent-src/commands/tests/e2e-heal.md +1 -1
- package/dist/agent-src/commands/tests/e2e-plan.md +1 -1
- package/dist/agent-src/contexts/authority/kernel-rule-edits.md +6 -6
- package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +1 -2
- package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +2 -2
- package/dist/agent-src/contexts/communication/rules-auto/token-efficiency-mechanics.md +88 -1
- package/dist/agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +1 -1
- package/dist/agent-src/contexts/contracts/frugality-charter.md +1 -1
- package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +1 -1
- package/dist/agent-src/contexts/execution/auto-orchestration-activation.md +1 -1
- package/dist/agent-src/contexts/execution/autonomy-mechanics.md +1 -1
- package/dist/agent-src/contexts/execution/cheap-question-mechanics.md +1 -1
- package/dist/agent-src/contexts/execution/contract-decision-sheet.md +3 -3
- package/dist/agent-src/contexts/execution/mandated-lines.md +1 -1
- package/dist/agent-src/contexts/execution/non-interactive-contract.md +1 -1
- package/dist/agent-src/contexts/execution/orchestration-telemetry.md +1 -1
- package/dist/agent-src/contexts/execution/plan-confidence-gate.md +5 -5
- package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +1 -1
- package/dist/agent-src/contexts/execution/subagent-modes-detail.md +1 -1
- package/dist/agent-src/contexts/execution/subagent-routing.md +2 -2
- package/dist/agent-src/contexts/execution/subagent-spawn-contract.md +1 -1
- package/dist/agent-src/contexts/execution/user-memory-channels.md +3 -3
- package/dist/agent-src/contexts/execution/verification-mechanics.md +1 -1
- package/dist/agent-src/contexts/judges/persona-voice-rubric.md +2 -2
- package/dist/agent-src/guidelines/abstraction-thresholds.md +88 -0
- package/dist/agent-src/guidelines/agent-infra/5w2h-analysis.md +260 -0
- package/dist/agent-src/guidelines/agent-infra/active-remediation-mechanics.md +99 -0
- package/dist/agent-src/guidelines/agent-infra/agent-interaction-and-decision-quality.md +325 -0
- package/dist/agent-src/guidelines/agent-infra/api-cost-levers.md +177 -0
- package/dist/agent-src/guidelines/agent-infra/artifact-drafting-protocol-mechanics.md +222 -0
- package/dist/agent-src/guidelines/agent-infra/ask-when-uncertain-demos.md +134 -0
- package/dist/agent-src/guidelines/agent-infra/asking-and-brevity-examples.md +198 -0
- package/dist/agent-src/guidelines/agent-infra/break-glass-usage.md +113 -0
- package/dist/agent-src/guidelines/agent-infra/carve-out-predicates.md +17 -0
- package/dist/agent-src/guidelines/agent-infra/comparison-matrix.md +179 -0
- package/dist/agent-src/guidelines/agent-infra/context-hygiene-mechanics.md +165 -0
- package/dist/agent-src/guidelines/agent-infra/corpus-grounding-authoring.md +91 -0
- package/dist/agent-src/guidelines/agent-infra/critical-thinking.md +156 -0
- package/dist/agent-src/guidelines/agent-infra/cross-source-consistency-mechanics.md +109 -0
- package/dist/agent-src/guidelines/agent-infra/developer-judgment.md +82 -0
- package/dist/agent-src/guidelines/agent-infra/direct-answers-demos.md +142 -0
- package/dist/agent-src/guidelines/agent-infra/domain-adoption-gates.md +112 -0
- package/dist/agent-src/guidelines/agent-infra/domain-eval-anti-pattern.md +53 -0
- package/dist/agent-src/guidelines/agent-infra/domain-pack-architecture.md +56 -0
- package/dist/agent-src/guidelines/agent-infra/downstream-changes-mechanics.md +91 -0
- package/dist/agent-src/guidelines/agent-infra/emphasis-budget.md +45 -0
- package/dist/agent-src/guidelines/agent-infra/engineering-memory-data-format.md +210 -0
- package/dist/agent-src/guidelines/agent-infra/evaluator-independence-mechanics.md +92 -0
- package/dist/agent-src/guidelines/agent-infra/existence-question-verdicts.md +80 -0
- package/dist/agent-src/guidelines/agent-infra/failure-signatures.md +70 -0
- package/dist/agent-src/guidelines/agent-infra/false-green.md +233 -0
- package/dist/agent-src/guidelines/agent-infra/first-principles.md +192 -0
- package/dist/agent-src/guidelines/agent-infra/framework-neutrality-patterns.md +66 -0
- package/dist/agent-src/guidelines/agent-infra/frontier-reasoning-operating-profile.md +169 -0
- package/dist/agent-src/guidelines/agent-infra/gate-authoring.md +177 -0
- package/dist/agent-src/guidelines/agent-infra/guarded-baseline.md +39 -0
- package/dist/agent-src/guidelines/agent-infra/installed-tools-manifest.md +142 -0
- package/dist/agent-src/guidelines/agent-infra/inversion-thinking.md +388 -0
- package/dist/agent-src/guidelines/agent-infra/ios-simulator-guide.md +378 -0
- package/dist/agent-src/guidelines/agent-infra/language-and-tone-examples.md +141 -0
- package/dist/agent-src/guidelines/agent-infra/layered-settings.md +317 -0
- package/dist/agent-src/guidelines/agent-infra/linked-projects-onboarding-gate.md +80 -0
- package/dist/agent-src/guidelines/agent-infra/mcp-request-signing.md +197 -0
- package/dist/agent-src/guidelines/agent-infra/memory-access.md +149 -0
- package/dist/agent-src/guidelines/agent-infra/mental-models.md +314 -0
- package/dist/agent-src/guidelines/agent-infra/minimal-safe-diff-mechanics.md +241 -0
- package/dist/agent-src/guidelines/agent-infra/missing-tool-handling.md +66 -0
- package/dist/agent-src/guidelines/agent-infra/model-recommendation.md +101 -0
- package/dist/agent-src/guidelines/agent-infra/naming.md +69 -0
- package/dist/agent-src/guidelines/agent-infra/notes-horizon-mechanics.md +90 -0
- package/dist/agent-src/guidelines/agent-infra/output-patterns.md +117 -0
- package/dist/agent-src/guidelines/agent-infra/recurring-criticism-mechanics.md +96 -0
- package/dist/agent-src/guidelines/agent-infra/reuse-verdict-mechanics.md +71 -0
- package/dist/agent-src/guidelines/agent-infra/review-routing-data-format.md +143 -0
- package/dist/agent-src/guidelines/agent-infra/roadmap-deferred-resolution-provenance.md +54 -0
- package/dist/agent-src/guidelines/agent-infra/roadmap-progress-mechanics.md +274 -0
- package/dist/agent-src/guidelines/agent-infra/role-contracts.md +209 -0
- package/dist/agent-src/guidelines/agent-infra/role-mode-router.md +89 -0
- package/dist/agent-src/guidelines/agent-infra/rule-body-migration-inventory.md +241 -0
- package/dist/agent-src/guidelines/agent-infra/rule-type-governance.md +73 -0
- package/dist/agent-src/guidelines/agent-infra/runtime-layer.md +89 -0
- package/dist/agent-src/guidelines/agent-infra/scqa-framework.md +526 -0
- package/dist/agent-src/guidelines/agent-infra/security-lint-containment.md +121 -0
- package/dist/agent-src/guidelines/agent-infra/self-improvement-pipeline.md +134 -0
- package/dist/agent-src/guidelines/agent-infra/simplicity-and-goal-demos.md +211 -0
- package/dist/agent-src/guidelines/agent-infra/six-hats.md +353 -0
- package/dist/agent-src/guidelines/agent-infra/size-and-scope.md +229 -0
- package/dist/agent-src/guidelines/agent-infra/skill-quality-checklist.md +157 -0
- package/dist/agent-src/guidelines/agent-infra/source-confidentiality-mechanics.md +109 -0
- package/dist/agent-src/guidelines/agent-infra/symptom-driven-harvest-loop.md +104 -0
- package/dist/agent-src/guidelines/agent-infra/systems-thinking.md +220 -0
- package/dist/agent-src/guidelines/agent-infra/tool-description-as-policy.md +35 -0
- package/dist/agent-src/guidelines/agent-infra/tool-integration.md +73 -0
- package/dist/agent-src/guidelines/agent-infra/traceability-field-mechanics.md +50 -0
- package/dist/agent-src/guidelines/agent-infra/untrusted-input-spotlighting.md +166 -0
- package/dist/agent-src/guidelines/agent-infra/verify-before-complete-demos.md +128 -0
- package/dist/agent-src/guidelines/augment-portability-patterns.md +70 -0
- package/dist/agent-src/guidelines/code-clarity.md +350 -0
- package/dist/agent-src/guidelines/component-oriented-and-oop-development.md +189 -0
- package/dist/agent-src/guidelines/cross-role-handoff.md +127 -0
- package/dist/agent-src/guidelines/design-antipatterns-triggers.json +18 -0
- package/dist/agent-src/guidelines/design-antipatterns.md +327 -0
- package/dist/agent-src/guidelines/design-asset-discipline.md +38 -0
- package/dist/agent-src/guidelines/design-canon.md +63 -0
- package/dist/agent-src/guidelines/design-fidelity-mechanics.md +293 -0
- package/dist/agent-src/guidelines/design-fidelity-routing.md +78 -0
- package/dist/agent-src/guidelines/design-handover-extraction.md +117 -0
- package/dist/agent-src/guidelines/design-modes.md +143 -0
- package/dist/agent-src/guidelines/design-reconciliation.md +172 -0
- package/dist/agent-src/guidelines/docs/readme-size-and-splitting.md +209 -0
- package/dist/agent-src/guidelines/e2e/playwright.md +363 -0
- package/dist/agent-src/guidelines/gtm-handoff.md +114 -0
- package/dist/agent-src/guidelines/monorepo-antipatterns.md +141 -0
- package/dist/agent-src/guidelines/php/api-design.md +115 -0
- package/dist/agent-src/guidelines/php/artisan-commands.md +81 -0
- package/dist/agent-src/guidelines/php/blade-ui.md +78 -0
- package/dist/agent-src/guidelines/php/controllers.md +90 -0
- package/dist/agent-src/guidelines/php/database.md +194 -0
- package/dist/agent-src/guidelines/php/eloquent.md +208 -0
- package/dist/agent-src/guidelines/php/flux.md +80 -0
- package/dist/agent-src/guidelines/php/general.md +207 -0
- package/dist/agent-src/guidelines/php/git.md +164 -0
- package/dist/agent-src/guidelines/php/jobs.md +111 -0
- package/dist/agent-src/guidelines/php/livewire.md +71 -0
- package/dist/agent-src/guidelines/php/logging.md +79 -0
- package/dist/agent-src/guidelines/php/naming.md +89 -0
- package/dist/agent-src/guidelines/php/patterns/dependency-injection.md +57 -0
- package/dist/agent-src/guidelines/php/patterns/dtos.md +199 -0
- package/dist/agent-src/guidelines/php/patterns/events.md +67 -0
- package/dist/agent-src/guidelines/php/patterns/factory.md +53 -0
- package/dist/agent-src/guidelines/php/patterns/pipelines.md +66 -0
- package/dist/agent-src/guidelines/php/patterns/policies.md +66 -0
- package/dist/agent-src/guidelines/php/patterns/repositories.md +122 -0
- package/dist/agent-src/guidelines/php/patterns/service-layer.md +64 -0
- package/dist/agent-src/guidelines/php/patterns/strategy.md +247 -0
- package/dist/agent-src/guidelines/php/patterns.md +28 -0
- package/dist/agent-src/guidelines/php/performance.md +92 -0
- package/dist/agent-src/guidelines/php/php-coding-patterns.md +80 -0
- package/dist/agent-src/guidelines/php/resources.md +100 -0
- package/dist/agent-src/guidelines/php/security.md +110 -0
- package/dist/agent-src/guidelines/php/sql.md +97 -0
- package/dist/agent-src/guidelines/php/validations.md +119 -0
- package/dist/agent-src/guidelines/php/websocket.md +100 -0
- package/dist/agent-src/guidelines/prompt-templates.md +189 -0
- package/dist/agent-src/guidelines/redundancy-taxonomy.md +208 -0
- package/dist/agent-src/guidelines/wing4-handoff.md +127 -0
- package/dist/agent-src/personas/README.md +1 -1
- package/dist/agent-src/personas/_template-specialist/persona.md +1 -1
- package/dist/agent-src/personas/product-owner.md +1 -1
- package/dist/agent-src/rules/active-remediation.md +1 -1
- package/dist/agent-src/rules/architecture.md +2 -2
- package/dist/agent-src/rules/artifact-drafting-protocol.md +1 -1
- package/dist/agent-src/rules/ask-when-uncertain.md +2 -2
- package/dist/agent-src/rules/brand-source-of-truth.md +9 -7
- package/dist/agent-src/rules/code-comment-discipline.md +2 -2
- package/dist/agent-src/rules/code-provenance.md +1 -1
- package/dist/agent-src/rules/content-quoting-floor.md +1 -1
- package/dist/agent-src/rules/context-hygiene.md +5 -5
- package/dist/agent-src/rules/cross-source-consistency.md +1 -1
- package/dist/agent-src/rules/design-fidelity.md +36 -46
- package/dist/agent-src/rules/direct-answers.md +2 -2
- package/dist/agent-src/rules/domain-adoption-policy.md +1 -1
- package/dist/agent-src/rules/evaluator-independence.md +1 -1
- package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +1 -1
- package/dist/agent-src/rules/icon-consistency.md +5 -1
- package/dist/agent-src/rules/improve-before-implement.md +1 -1
- package/dist/agent-src/rules/language-and-tone.md +3 -3
- package/dist/agent-src/rules/minimal-safe-diff.md +1 -1
- package/dist/agent-src/rules/notes-first-reasoning.md +2 -2
- package/dist/agent-src/rules/recurring-criticism.md +1 -1
- package/dist/agent-src/rules/roadmap-progress-sync.md +1 -1
- package/dist/agent-src/rules/role-mode-adherence.md +2 -2
- package/dist/agent-src/rules/security-sensitive-stop.md +1 -1
- package/dist/agent-src/rules/size-enforcement.md +1 -1
- package/dist/agent-src/rules/source-confidentiality.md +2 -2
- package/dist/agent-src/rules/think-before-action.md +1 -1
- package/dist/agent-src/rules/token-efficiency.md +7 -5
- package/dist/agent-src/rules/ui-audit-gate.md +3 -2
- package/dist/agent-src/rules/untrusted-input-defense.md +3 -3
- package/dist/agent-src/skills/activation-design/SKILL.md +2 -2
- package/dist/agent-src/skills/adr-create/SKILL.md +5 -5
- package/dist/agent-src/skills/ai-council/SKILL.md +1 -1
- package/dist/agent-src/skills/ai-council/references/advanced-modes.md +1 -1
- package/dist/agent-src/skills/blade-ui/SKILL.md +1 -1
- package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +1 -1
- package/dist/agent-src/skills/brand-to-tokens/SKILL.md +24 -3
- package/dist/agent-src/skills/bug-analyzer/SKILL.md +1 -1
- package/dist/agent-src/skills/build-buy-partner/SKILL.md +1 -1
- package/dist/agent-src/skills/churn-prevention/SKILL.md +2 -2
- package/dist/agent-src/skills/code-refactoring/SKILL.md +3 -3
- package/dist/agent-src/skills/code-review/SKILL.md +3 -3
- package/dist/agent-src/skills/command-writing/SKILL.md +3 -3
- package/dist/agent-src/skills/comp-banding/SKILL.md +1 -1
- package/dist/agent-src/skills/competitive-moat-analysis/SKILL.md +1 -1
- package/dist/agent-src/skills/competitive-positioning/SKILL.md +2 -2
- package/dist/agent-src/skills/complexity-first-planning/SKILL.md +1 -1
- package/dist/agent-src/skills/condense-memory/SKILL.md +1 -1
- package/dist/agent-src/skills/content-funnel-design/SKILL.md +2 -2
- package/dist/agent-src/skills/contracts-cognition/SKILL.md +1 -1
- package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md +2 -2
- package/dist/agent-src/skills/corpus-grounding/SKILL.md +2 -2
- package/dist/agent-src/skills/customer-research/SKILL.md +2 -2
- package/dist/agent-src/skills/dashboard-design/SKILL.md +1 -1
- package/dist/agent-src/skills/data-handling-judgment/SKILL.md +1 -1
- package/dist/agent-src/skills/deal-qualification-meddic/SKILL.md +2 -2
- package/dist/agent-src/skills/decision-record/SKILL.md +3 -3
- package/dist/agent-src/skills/decision-review/SKILL.md +8 -8
- package/dist/agent-src/skills/deep-reading-analyst/SKILL.md +22 -22
- package/dist/agent-src/skills/design-intelligence/SKILL.md +4 -4
- package/dist/agent-src/skills/design-intelligence/references/context-and-registers.md +2 -2
- package/dist/agent-src/skills/design-review/SKILL.md +4 -4
- package/dist/agent-src/skills/design-system-capture/references/design-system-json.md +20 -1
- package/dist/agent-src/skills/design-tokens/SKILL.md +17 -2
- package/dist/agent-src/skills/design-variations/SKILL.md +2 -2
- package/dist/agent-src/skills/developer-like-execution/SKILL.md +2 -2
- package/dist/agent-src/skills/discovery-interview/SKILL.md +2 -2
- package/dist/agent-src/skills/doc-coauthoring/SKILL.md +3 -3
- package/dist/agent-src/skills/editorial-calendar/SKILL.md +2 -2
- package/dist/agent-src/skills/existing-ui-audit/SKILL.md +44 -1
- package/dist/agent-src/skills/existing-ui-audit/references/anti-slop-cross-reference.md +2 -2
- package/dist/agent-src/skills/expansion-playbook/SKILL.md +2 -2
- package/dist/agent-src/skills/experiment-loop/SKILL.md +1 -1
- package/dist/agent-src/skills/experiment-loop/references/protocol.md +1 -1
- package/dist/agent-src/skills/fe-design/SKILL.md +3 -3
- package/dist/agent-src/skills/fe-design/references/design-patterns.md +1 -1
- package/dist/agent-src/skills/fe-design/references/design-read-and-memory.md +3 -3
- package/dist/agent-src/skills/fe-design/references/source-led-port.md +1 -1
- package/dist/agent-src/skills/feature-planning/SKILL.md +1 -1
- package/dist/agent-src/skills/flux/SKILL.md +1 -1
- package/dist/agent-src/skills/forecast-accuracy/SKILL.md +2 -2
- package/dist/agent-src/skills/forecasting/SKILL.md +2 -2
- package/dist/agent-src/skills/fundraising-narrative/SKILL.md +2 -2
- package/dist/agent-src/skills/funnel-analysis/SKILL.md +2 -2
- package/dist/agent-src/skills/gtm-launch/SKILL.md +2 -2
- package/dist/agent-src/skills/hiring-loop-design/SKILL.md +1 -1
- package/dist/agent-src/skills/html-deck/SKILL.md +5 -5
- package/dist/agent-src/skills/humanizer/SKILL.md +1 -1
- package/dist/agent-src/skills/humanizer/data/patterns.md +1 -1
- package/dist/agent-src/skills/iconography/SKILL.md +3 -3
- package/dist/agent-src/skills/judge-synthesis/SKILL.md +1 -1
- package/dist/agent-src/skills/laravel-api-endpoint/SKILL.md +2 -2
- package/dist/agent-src/skills/launch-readiness/SKILL.md +3 -3
- package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +6 -6
- package/dist/agent-src/skills/livewire/SKILL.md +1 -1
- package/dist/agent-src/skills/market-entry-analysis/SKILL.md +1 -1
- package/dist/agent-src/skills/mcp-builder/SKILL.md +1 -1
- package/dist/agent-src/skills/memory-consolidation/SKILL.md +3 -3
- package/dist/agent-src/skills/messaging-architecture/SKILL.md +2 -2
- package/dist/agent-src/skills/monorepo-workspace/SKILL.md +1 -1
- package/dist/agent-src/skills/onboarding-design/SKILL.md +2 -2
- package/dist/agent-src/skills/onboarding-program/SKILL.md +1 -1
- package/dist/agent-src/skills/one-on-one-cadence/SKILL.md +1 -1
- package/dist/agent-src/skills/org-design/SKILL.md +1 -1
- package/dist/agent-src/skills/overbuild-review-lens/SKILL.md +3 -3
- package/dist/agent-src/skills/override-management/SKILL.md +1 -1
- package/dist/agent-src/skills/perf-feedback-craft/SKILL.md +1 -1
- package/dist/agent-src/skills/persona-writing/SKILL.md +1 -1
- package/dist/agent-src/skills/php-coder/SKILL.md +1 -1
- package/dist/agent-src/skills/pipeline-strategy/SKILL.md +2 -2
- package/dist/agent-src/skills/playwright-testing/SKILL.md +3 -3
- package/dist/agent-src/skills/po-discovery/SKILL.md +1 -1
- package/dist/agent-src/skills/positioning-strategy/SKILL.md +2 -2
- package/dist/agent-src/skills/privacy-review/SKILL.md +1 -1
- package/dist/agent-src/skills/prompt-optimizer/SKILL.md +3 -3
- package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +1 -1
- package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +2 -2
- package/dist/agent-src/skills/receiving-code-review/SKILL.md +1 -1
- package/dist/agent-src/skills/refine-ticket/SKILL.md +2 -2
- package/dist/agent-src/skills/release-comms/SKILL.md +2 -2
- package/dist/agent-src/skills/retention-loops/SKILL.md +2 -2
- package/dist/agent-src/skills/review-routing/SKILL.md +2 -2
- package/dist/agent-src/skills/roadmap-management/SKILL.md +1 -1
- package/dist/agent-src/skills/roadmap-management/references/archival.md +1 -1
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +5 -5
- package/dist/agent-src/skills/rule-writing/SKILL.md +6 -6
- package/dist/agent-src/skills/runway-cognition/SKILL.md +2 -2
- package/dist/agent-src/skills/scenario-modeling/SKILL.md +2 -2
- package/dist/agent-src/skills/skill-writing/SKILL.md +2 -2
- package/dist/agent-src/skills/skill-writing/references/procedure.md +1 -1
- package/dist/agent-src/skills/skill-writing/references/section-patterns.md +3 -3
- package/dist/agent-src/skills/spreadsheet-authoring/SKILL.md +1 -1
- package/dist/agent-src/skills/stakeholder-tradeoff/SKILL.md +3 -3
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +1 -1
- package/dist/agent-src/skills/supply-chain-intake/SKILL.md +1 -1
- package/dist/agent-src/skills/systematic-debugging/SKILL.md +2 -2
- package/dist/agent-src/skills/tailwind-engineer/SKILL.md +11 -5
- package/dist/agent-src/skills/throughput-vs-morale-tradeoff/SKILL.md +1 -1
- package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
- package/dist/agent-src/skills/typography-system/SKILL.md +2 -2
- package/dist/agent-src/skills/ui-component-architect/SKILL.md +28 -8
- package/dist/agent-src/skills/unit-economics-modeling/SKILL.md +2 -2
- package/dist/agent-src/skills/upstream-contribute/SKILL.md +1 -1
- package/dist/agent-src/skills/validate-feature-fit/SKILL.md +2 -2
- package/dist/agent-src/skills/verify-repair-loop/SKILL.md +2 -2
- package/dist/agent-src/skills/vision-articulation/SKILL.md +1 -1
- package/dist/agent-src/skills/voc-extract/SKILL.md +2 -2
- package/dist/agent-src/skills/voice-and-tone-design/SKILL.md +2 -2
- package/dist/agent-src/skills/wireframe/SKILL.md +1 -1
- package/dist/agent-src/skills/workspace-link/SKILL.md +1 -1
- package/dist/agent-src/templates/agent-settings.md +6 -6
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/dist/agent-src/templates/contexts/knowledge-pages.md +2 -3
- package/dist/agent-src/templates/copilot-instructions.md +1 -1
- package/dist/agent-src/templates/roadmaps.md +1 -1
- package/dist/agent-src/templates/scripts/README.md +2 -2
- package/dist/agent-src/user-types/_template/user-type.md +1 -1
- package/dist/cli-delegate/check_update_banner.js +12 -1
- package/dist/cli-delegate/{chunk-NLP54U3J.js → chunk-2XY7ILBT.js} +13 -1
- package/dist/cli-delegate/{chunk-IAI3XL43.js → chunk-3FKR64R5.js} +22 -6
- package/dist/cli-delegate/{chunk-J3RFNKG4.js → chunk-55ACLDUE.js} +2 -2
- package/dist/cli-delegate/{chunk-PKOBQADP.js → chunk-57PN4GYJ.js} +1 -1
- package/dist/cli-delegate/{chunk-KCNTUSPI.js → chunk-AK6HODNQ.js} +4 -4
- package/dist/cli-delegate/{chunk-2FTMENJL.js → chunk-GYC3VRYN.js} +1 -1
- package/dist/cli-delegate/{chunk-LWTYTX6F.js → chunk-HZ52BRGG.js} +24 -18
- package/dist/cli-delegate/{chunk-6RJA2F5A.js → chunk-IVBPRCQO.js} +1 -1
- package/dist/cli-delegate/{chunk-I6RHFQEG.js → chunk-YUM5KURG.js} +17 -1
- package/dist/cli-delegate/cmd_analyze_session.js +1 -1
- package/dist/cli-delegate/cmd_brand_status.js +1 -1
- package/dist/cli-delegate/cmd_conformance.js +3 -3
- package/dist/cli-delegate/cmd_doctor.js +3 -3
- package/dist/cli-delegate/cmd_explain.js +2 -2
- package/dist/cli-delegate/cmd_export.js +4 -4
- package/dist/cli-delegate/cmd_handoff.js +4 -4
- package/dist/cli-delegate/cmd_mcp_available.js +1 -1
- package/dist/cli-delegate/cmd_memory_get.js +1 -1
- package/dist/cli-delegate/cmd_migrate.js +2 -2
- package/dist/cli-delegate/cmd_packs_active.js +2 -2
- package/dist/cli-delegate/cmd_prune.js +4 -4
- package/dist/cli-delegate/cmd_route_audit.js +3 -3
- package/dist/cli-delegate/cmd_route_explain.js +1 -1
- package/dist/cli-delegate/cmd_session_recycle.js +1 -1
- package/dist/cli-delegate/cmd_settings_get.js +15 -9
- package/dist/cli-delegate/cmd_settings_migrate.js +4 -4
- package/dist/cli-delegate/cmd_settings_set.js +41 -11
- package/dist/cli-delegate/cmd_sync.js +4 -4
- package/dist/cli-delegate/cmd_uninstall.js +4 -4
- package/dist/cli-delegate/cmd_update.js +1 -1
- package/dist/cli-delegate/cmd_upgrade.js +1 -1
- package/dist/cli-delegate/cmd_validate.js +4 -4
- package/dist/cli-delegate/cmd_versions.js +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +22 -75
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +3 -3
- package/dist/discovery/dormancy-report.md +1 -1
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +5 -7
- package/dist/discovery/trust-report.md +2 -2
- package/dist/discovery/workspaces.json +4 -6
- package/dist/hooks/dispatch.js +8607 -8930
- package/dist/install/install.mjs +35 -8
- package/dist/mcp/registry-manifest.json +3 -3
- package/dist/mcp/server.json +2 -2
- package/dist/mcp/server.mjs +1433 -1342
- package/dist/router.json +1 -1
- package/dist/scripts/_lib/agent_settings.js +73 -0
- package/dist/scripts/_lib/agent_src.js +20 -0
- package/dist/scripts/_lib/guidelines_lane.js +158 -0
- package/dist/scripts/condense.js +2 -5
- package/dist/server/io/yamlIO.js +125 -17
- package/dist/server/schemas/settings.js +18 -4
- package/dist/shared/settingsSurface.js +6 -1
- package/docs/contracts/settings-classes.md +18 -9
- package/docs/guidelines/abstraction-thresholds.md +35 -0
- package/docs/guidelines/agent-infra/active-remediation-mechanics.md +3 -3
- package/docs/guidelines/agent-infra/false-green.md +2 -2
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +1 -1
- package/docs/guidelines/agent-infra/skill-quality-checklist.md +1 -1
- package/docs/guidelines/design-fidelity-mechanics.md +4 -0
- package/docs/guidelines/design-fidelity-routing.md +78 -0
- package/docs/guidelines/design-reconciliation.md +172 -0
- package/docs/guidelines/gtm-handoff.md +2 -2
- package/docs/guidelines/wing4-handoff.md +2 -2
- package/package.json +7 -3
- package/src/config/agent-settings.template.yml +55 -8
- package/src/config/ci-local-parity.yml +34 -0
- package/src/config/continuity-surface.json +4 -32
- package/src/config/gate-coverage.yml +31 -8
- package/src/config/gate-reachability-exemptions.json +1 -0
- package/src/config/gate-violation-baselines.json +3 -3
- package/src/config/hook-token-budget.json +1 -1
- package/src/config/host-injection-effect.json +2 -2
- package/src/config/pack-size-budget.json +55 -4
- package/src/config/platform-anchor.json +47 -0
- package/src/config/preamble-payload-budget.json +2 -3
- package/src/config/publish-surface.json +4 -2
- package/src/config/ratification-policy.json +7 -0
- package/src/config/rule-stub-ceilings.json +16 -9
- package/src/scripts/_cli/cmd_settings_get.ts +22 -7
- package/src/scripts/_lib/agent_settings.ts +85 -0
- package/src/scripts/_lib/agent_src.ts +21 -0
- package/src/scripts/_lib/artifact_maturity.ts +242 -0
- package/src/scripts/_lib/conformance_report.ts +403 -0
- package/src/scripts/_lib/continuity_writer.ts +72 -13
- package/src/scripts/_lib/design_system_import.ts +20 -0
- package/src/scripts/_lib/design_tolerance.ts +281 -0
- package/src/scripts/_lib/guidelines_lane.ts +164 -0
- package/src/scripts/_lib/obligation_frequency.ts +2 -3
- package/src/scripts/_lib/platform_anchor.ts +1053 -0
- package/src/scripts/_lib/ratification_artifact.ts +278 -0
- package/src/scripts/_lib/security_lint.ts +23 -2
- package/src/scripts/_lib/self_repair.ts +21 -0
- package/src/scripts/_lib/session_index_trust.ts +42 -1
- package/src/scripts/_lib/standing_bound_ratchet.ts +103 -37
- package/src/scripts/_lib/tolerance_shadow.ts +177 -0
- package/src/scripts/ai_council/redact_low_impact_entry.ts +8 -0
- package/src/scripts/autonomy_friction_traffic.ts +379 -0
- package/src/scripts/check_kernel_edit_ratified.ts +462 -0
- package/src/scripts/check_loss_class_declared.ts +793 -46
- package/src/scripts/check_platform_anchor.ts +390 -0
- package/src/scripts/check_preamble_payload_budget.ts +292 -4
- package/src/scripts/check_projected_rule_routes.ts +395 -0
- package/src/scripts/code_graph/cli.ts +6 -0
- package/src/scripts/condense.ts +2 -6
- package/src/scripts/generate_host_cost_table.ts +354 -0
- package/src/scripts/hook_manifest.json +1 -1
- package/src/scripts/hook_manifest.yaml +35 -27
- package/src/scripts/hooks/category_a.ts +1 -1
- package/src/scripts/hooks/chain_nudge_hook.ts +311 -25
- package/src/scripts/hooks/session_eol_hook.ts +68 -154
- package/src/scripts/hooks/source_first_gate_hook.ts +12 -0
- package/src/scripts/hooks/ui_route_nudge_hook.ts +52 -15
- package/src/scripts/hot_context_hook.ts +41 -401
- package/src/scripts/lint_evidence_artifacts.ts +1 -0
- package/src/scripts/lint_knowledge_scale.ts +0 -26
- package/src/scripts/memory_lookup.ts +9 -9
- package/src/scripts/report_standing_payload_by_host.ts +7 -7
- package/src/scripts/session_memory_index.ts +5 -0
- package/src/scripts/sync_agent_settings.ts +270 -10
- package/src/server/io/yamlIO.ts +127 -17
- package/src/server/schemas/settings.ts +25 -5
- package/src/shared/settingsSurface.ts +13 -2
- package/src/templates/compact-instructions.md +8 -3
- package/dist/agent-src/commands/chat-history/import.md +0 -170
- package/dist/agent-src/commands/chat-history.md +0 -63
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
# size-and-scope-guidelines
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Ensure all system components stay:
|
|
6
|
+
|
|
7
|
+
- readable
|
|
8
|
+
- maintainable
|
|
9
|
+
- executable
|
|
10
|
+
- non-redundant
|
|
11
|
+
|
|
12
|
+
Prevent:
|
|
13
|
+
- oversized rules
|
|
14
|
+
- bloated skills
|
|
15
|
+
- command overreach
|
|
16
|
+
- duplicated knowledge
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
# Core principle
|
|
21
|
+
|
|
22
|
+
> Split by responsibility, NOT by length.
|
|
23
|
+
|
|
24
|
+
Size is a signal — not the goal.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
# Golden size rules
|
|
29
|
+
|
|
30
|
+
## Rules & system instructions
|
|
31
|
+
|
|
32
|
+
- Ideal: **< 60 lines**
|
|
33
|
+
- Acceptable: **< 100–120 lines**
|
|
34
|
+
- Hard limit: **< 200 lines**
|
|
35
|
+
|
|
36
|
+
Linter (structural model, 2026-05-08 — see
|
|
37
|
+
[`docs/contracts/linter-structural-model.md`](../../contracts/linter-structural-model.md)):
|
|
38
|
+
the long-rule warning fires only when the rule is **> 60 non-empty
|
|
39
|
+
lines AND density < 0.50 AND ships no Iron-Law block**. Rules whose
|
|
40
|
+
body is a verbatim ALL-CAPS imperative (`commit-policy`,
|
|
41
|
+
`ask-when-uncertain`, `direct-answers`) are auto-exempt — no
|
|
42
|
+
frontmatter flag required. The 200-line hard error stays
|
|
43
|
+
unconditional.
|
|
44
|
+
|
|
45
|
+
Reason:
|
|
46
|
+
- Loaded frequently
|
|
47
|
+
- Must be reliably followed
|
|
48
|
+
- Large files get partially ignored
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## Skills
|
|
53
|
+
|
|
54
|
+
- Target: **300–900 words**
|
|
55
|
+
- Warning: **> 400 lines AND (density < 0.60 OR ≥ 2 `## Procedure`
|
|
56
|
+
blocks)** — structural model, 2026-05-08
|
|
57
|
+
- Reference-rich skills with high density (`quality-tools` at 0.83,
|
|
58
|
+
catalogue-style skills) pass without splitting; the multi-procedure
|
|
59
|
+
trigger flags genuine cluster-split candidates regardless of size
|
|
60
|
+
|
|
61
|
+
Focus:
|
|
62
|
+
- scanability
|
|
63
|
+
- one responsibility
|
|
64
|
+
- executable workflow
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Commands
|
|
69
|
+
|
|
70
|
+
- Target: **200–600 words**
|
|
71
|
+
- Acceptable: **up to ~1000 words**
|
|
72
|
+
- Warning: **> 1000 words AND no delegation signal AND density < 0.65**
|
|
73
|
+
— structural model, 2026-05-08. A delegation signal is either
|
|
74
|
+
frontmatter (`cluster:` / `routes_to:`) OR ≥ 3 markdown links to
|
|
75
|
+
other `.md` files. Well-factored orchestrators pass automatically;
|
|
76
|
+
inlined logic in a non-orchestrator command warns.
|
|
77
|
+
|
|
78
|
+
Commands orchestrate — not implement.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## AGENTS.md
|
|
83
|
+
|
|
84
|
+
- Enforced budget: **character caps** via `lint_agents_md.ts` — package
|
|
85
|
+
root fails at **3,000 chars** (warns 2,800); consumer template fails at
|
|
86
|
+
**2,500 chars** (warns 2,300).
|
|
87
|
+
- Word guidance: aim for **≤ ~450 words** — that is roughly what fits
|
|
88
|
+
under the 3,000-char cap.
|
|
89
|
+
|
|
90
|
+
High-level only.
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## copilot-instructions.md
|
|
95
|
+
|
|
96
|
+
- Ideal: **< 60 lines**
|
|
97
|
+
- Acceptable: **< 100–150 lines**
|
|
98
|
+
- Note: Copilot Code Review reads only the **first 4,000 characters**
|
|
99
|
+
(see `src/agent-src/templates/copilot-instructions.md`), so the
|
|
100
|
+
effective cap is character-based — highest-priority rules go up top.
|
|
101
|
+
|
|
102
|
+
Must stay lightweight.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Guidelines
|
|
107
|
+
|
|
108
|
+
- Target: **400–1500 words**
|
|
109
|
+
- Can exceed if needed
|
|
110
|
+
|
|
111
|
+
Guidelines are reference — not execution.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## Knowledge cards
|
|
116
|
+
|
|
117
|
+
Committed knowledge cards (`agents/knowledge/<source>.md`) are a size-bounded,
|
|
118
|
+
evidence-disciplined context type:
|
|
119
|
+
|
|
120
|
+
- Hard bound: **≤ 150 lines** — a card is a thin distillation, never a mirror.
|
|
121
|
+
- **Mandatory** `links.authoritative` pointer (path or URL).
|
|
122
|
+
- Enforced by `check_knowledge_cards.ts` (pointer-resolution CI + size +
|
|
123
|
+
trust-tag + multi-evidence git-ancestry consistency; `--strict` adds a
|
|
124
|
+
content-compare). Durable content = negative facts + pointers; positive
|
|
125
|
+
structure is a per-line, last-verified hypothesis.
|
|
126
|
+
|
|
127
|
+
See [`source-discovery`](../../skills/source-discovery/SKILL.md) and the
|
|
128
|
+
`evidence-discipline` context for the full model.
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
# Component responsibilities
|
|
133
|
+
|
|
134
|
+
## Rules
|
|
135
|
+
|
|
136
|
+
- constraints only
|
|
137
|
+
- no workflows
|
|
138
|
+
- no long explanations
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## Skills
|
|
143
|
+
|
|
144
|
+
Must contain:
|
|
145
|
+
|
|
146
|
+
- When to use
|
|
147
|
+
- Procedure
|
|
148
|
+
- Validation
|
|
149
|
+
- Output format
|
|
150
|
+
- Gotchas
|
|
151
|
+
- Do NOT
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## Commands
|
|
156
|
+
|
|
157
|
+
- orchestrate workflows
|
|
158
|
+
- delegate to skills
|
|
159
|
+
- do not contain deep logic
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## Guidelines
|
|
164
|
+
|
|
165
|
+
- define conventions
|
|
166
|
+
- support skills
|
|
167
|
+
- must NOT replace workflows
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## AGENTS.md
|
|
172
|
+
|
|
173
|
+
- entrypoint
|
|
174
|
+
- system overview
|
|
175
|
+
- interaction model
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## copilot-instructions.md
|
|
180
|
+
|
|
181
|
+
- behavioral hints
|
|
182
|
+
- style guidance
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
# Anti-patterns
|
|
187
|
+
|
|
188
|
+
## Too large
|
|
189
|
+
|
|
190
|
+
- skill solves multiple problems
|
|
191
|
+
- rule explains instead of constraining
|
|
192
|
+
- command contains implementation
|
|
193
|
+
- AGENTS.md becomes documentation dump
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## Too small
|
|
198
|
+
|
|
199
|
+
- skill has no real workflow
|
|
200
|
+
- rule is just a suggestion
|
|
201
|
+
- command adds no value
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
# Boundary rule (critical)
|
|
206
|
+
|
|
207
|
+
> A skill must remain usable WITHOUT opening a guideline.
|
|
208
|
+
|
|
209
|
+
If not → the skill is too weak.
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
# Decision checklist
|
|
214
|
+
|
|
215
|
+
Before creating or modifying:
|
|
216
|
+
|
|
217
|
+
1. Is this a constraint → Rule
|
|
218
|
+
2. Is this a workflow → Skill
|
|
219
|
+
3. Is this orchestration → Command
|
|
220
|
+
4. Is this reference → Guideline
|
|
221
|
+
5. Is this entrypoint → AGENTS.md
|
|
222
|
+
6. Is this behavior hint → copilot-instructions.md
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
# Final principle
|
|
227
|
+
|
|
228
|
+
> Small enough to understand quickly
|
|
229
|
+
> Large enough to be useful
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Skill Quality
|
|
2
|
+
|
|
3
|
+
> Creating, editing, or reviewing skills — minimum quality standard, every skill must be executable, validated, and self-contained
|
|
4
|
+
|
|
5
|
+
_Origin: migrated from `.agent-src.uncondensed/rules/skill-quality.md` per P4.2 of `road-to-kernel-and-router.md`._
|
|
6
|
+
|
|
7
|
+
# Skill Quality
|
|
8
|
+
|
|
9
|
+
## Minimum Sharpness
|
|
10
|
+
|
|
11
|
+
Every skill must answer four questions. If ANY answer is weak, the skill is not done.
|
|
12
|
+
|
|
13
|
+
| # | Question | Section | Standard |
|
|
14
|
+
|---|---|---|---|
|
|
15
|
+
| 1 | When should I use this? | `When to use` | Concrete trigger, not generic |
|
|
16
|
+
| 2 | What exactly do I do? | `Procedure` | Executable steps with decisions |
|
|
17
|
+
| 3 | How do I verify it worked? | `Procedure` (validation step) | Concrete checks, not "verify it works" |
|
|
18
|
+
| 4 | What common failure must I avoid? | `Gotcha` + `Do NOT` | Real failure patterns, not platitudes |
|
|
19
|
+
|
|
20
|
+
## Register — explain the trade-off, except in the safety kernel
|
|
21
|
+
|
|
22
|
+
Two registers, chosen by artifact class (U4, ecosystem harvest 2026-07-13):
|
|
23
|
+
|
|
24
|
+
- **Capability skills** (workflows, analyses, generators) **explain the
|
|
25
|
+
trade-off** — say *why* the recommended path beats the alternative instead of
|
|
26
|
+
shouting ALL-CAPS MUSTs; an agent that understands the why generalizes to
|
|
27
|
+
cases the skill never enumerated.
|
|
28
|
+
- **The safety kernel keeps its imperative Iron-Law register** — kernel rules,
|
|
29
|
+
safety floors (`*-safety-floor`), and Hard-Floor surfaces stay ALL-CAPS
|
|
30
|
+
fenced-law imperative, non-negotiable (`preservation-guard` enforces the
|
|
31
|
+
byte-level protection). Never downgrade an Iron Law to friendly prose.
|
|
32
|
+
|
|
33
|
+
## Required Sections
|
|
34
|
+
|
|
35
|
+
Every skill MUST have: `When to use`, `Procedure`, `Gotcha`, `Output format`, `Do NOT`.
|
|
36
|
+
|
|
37
|
+
## Frontmatter Contract
|
|
38
|
+
|
|
39
|
+
Every skill's YAML frontmatter MUST validate against `scripts/schemas/skill.schema.json`.
|
|
40
|
+
Violations are reported by `scripts/skill_linter.ts` as `schema_<rule>` errors
|
|
41
|
+
and fail `./scripts-run src/scripts/validate_frontmatter` and the full CI pipeline.
|
|
42
|
+
|
|
43
|
+
### Omit fields equal to their schema default
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
NEVER write a frontmatter field whose value equals its schema `default`.
|
|
47
|
+
OMIT IT — the loader injects the default at read time.
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
A field that carries the schema `default` (e.g. `trust.level: core`,
|
|
51
|
+
`install.default: true`, `lifecycle: active`, `source: package`,
|
|
52
|
+
`command.disable-model-invocation: true`) is redundant:
|
|
53
|
+
`validate_frontmatter.apply_schema_defaults` injects it transparently for
|
|
54
|
+
every consumer (validator, discovery manifest, drift checksum). Writing it
|
|
55
|
+
anyway is boilerplate that `scripts/lint_frontmatter_boilerplate.ts` rejects
|
|
56
|
+
(wired into this repository's `ci-fast` task). To strip it across the tree, run
|
|
57
|
+
`./scripts-run src/scripts/migrate_frontmatter_defaults`. Background:
|
|
58
|
+
`road-to-abstraction-reduction.md` +
|
|
59
|
+
`agents/evidence/analysis/abstraction-reduction-preflight.md`.
|
|
60
|
+
|
|
61
|
+
> **Changing a default is a breaking change.** The schema `default` is a
|
|
62
|
+
> contract: artefacts that omit the field inherit whatever the default *is at
|
|
63
|
+
> read time*. Flipping a default value (e.g. `lifecycle: active → deprecated`)
|
|
64
|
+
> silently re-defaults every artefact that omits the field — so a default
|
|
65
|
+
> change must pair with a re-run of `migrate_frontmatter_defaults.ts` and an
|
|
66
|
+
> explicit review of the affected artefacts.
|
|
67
|
+
|
|
68
|
+
## Description Triggering
|
|
69
|
+
|
|
70
|
+
Claude routes skills by their frontmatter `description`. Pushy,
|
|
71
|
+
trigger-rich descriptions are required — polite or hedged ones cause
|
|
72
|
+
undertriggering. The full recipe (concrete verb phrase, ≥2 triggers,
|
|
73
|
+
`even if they don't explicitly ask for …` tail, ≤200 chars,
|
|
74
|
+
litmus test) lives in
|
|
75
|
+
[`contexts/communication/rules-auto/skill-quality-mechanics.md`](../../contexts/communication/rules-auto/skill-quality-mechanics.md)
|
|
76
|
+
§ Description Triggering.
|
|
77
|
+
|
|
78
|
+
## Skill Independence
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
If a skill is not executable without opening a guideline, it is broken.
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
- Skills MAY reference guidelines for detailed conventions
|
|
85
|
+
- Skills MUST NOT outsource their core workflow to guidelines
|
|
86
|
+
- If removing guideline references makes the skill useless → the skill is too weak
|
|
87
|
+
|
|
88
|
+
**Litmus test:** Cover all guideline references in the Procedure. Is it still executable?
|
|
89
|
+
If not → the skill needs more own steps, decisions, and validation — not more guideline links.
|
|
90
|
+
|
|
91
|
+
## Merge & Condensation Preservation
|
|
92
|
+
|
|
93
|
+
When merging or condensing skills, the result MUST preserve the
|
|
94
|
+
strongest validation, strongest examples, all anti-patterns, all
|
|
95
|
+
decision criteria, and trigger quality. Full preservation invariants
|
|
96
|
+
and "merge is invalid if …" / "condensation may remove …" lists in
|
|
97
|
+
[`contexts/communication/rules-auto/skill-quality-mechanics.md`](../../contexts/communication/rules-auto/skill-quality-mechanics.md)
|
|
98
|
+
§ Merge Preservation and § Condensation Preservation.
|
|
99
|
+
|
|
100
|
+
## Refactor Safety
|
|
101
|
+
|
|
102
|
+
When refactoring or optimizing skills:
|
|
103
|
+
|
|
104
|
+
- NEVER weaken validation to pass linter
|
|
105
|
+
- NEVER remove anti-patterns to reduce size
|
|
106
|
+
- NEVER replace concrete checks with "verify it works"
|
|
107
|
+
- NEVER merge skills if the result is broader than either source
|
|
108
|
+
- ALWAYS run linter before and after — fail count must not increase
|
|
109
|
+
|
|
110
|
+
## Senior-Tier Required Structure
|
|
111
|
+
|
|
112
|
+
Skills with `tier: senior` in YAML frontmatter MUST carry four named
|
|
113
|
+
blocks beyond the standard required sections:
|
|
114
|
+
|
|
115
|
+
| # | Block | Heading / Location | Standard |
|
|
116
|
+
|---|---|---|---|
|
|
117
|
+
| 1 | Context-First lead | Frontmatter `description` | First sentence anchors the cognition cluster (domain + senior role); second sentence names the trigger. |
|
|
118
|
+
| 2 | Related Skills | `## Related Skills` | Two-list pattern — `**WHEN to use this**` (situations this skill resolves) + `**WHEN NOT to use this**` (route-elsewhere peers, named). |
|
|
119
|
+
| 3 | Proactive Triggers | `## When the agent should load this` | 3–5 concrete user-prompt patterns (paraphrases users actually type), not abstract categories. |
|
|
120
|
+
| 4 | Output Artifacts | `## Output` | 1–4 named artifacts with shape (file path, table, markdown structure) — orchestrator-citable identifier each. |
|
|
121
|
+
|
|
122
|
+
**Forward-only.** `scripts/skill_linter.ts` enforces these blocks for
|
|
123
|
+
`tier: senior` skills only; mid-tier and untiered skills skip the
|
|
124
|
+
check. No retrofit pass on existing Wing-1 skills.
|
|
125
|
+
|
|
126
|
+
Subsection specs (≤ 6-line spec + 1 reference example each), good /
|
|
127
|
+
bad pattern pairs, and the WHEN-NOT routing peer rules live in
|
|
128
|
+
[`contexts/communication/rules-auto/skill-quality-mechanics.md`](../../contexts/communication/rules-auto/skill-quality-mechanics.md)
|
|
129
|
+
§ Senior-tier patterns.
|
|
130
|
+
|
|
131
|
+
## Structural Malice Floor
|
|
132
|
+
|
|
133
|
+
`scripts/skill_linter.ts` runs five regex patterns against every
|
|
134
|
+
skill / rule / command body — credential exfiltration, remote
|
|
135
|
+
execution, force-push to a protected ref, world-readable secret
|
|
136
|
+
files, and shell-injection in subprocess calls. A match emits
|
|
137
|
+
``Issue("error", "malice:<pattern>", "<line>:<matched>")`` and the
|
|
138
|
+
linter exits with code **3** (security-failure), distinct from
|
|
139
|
+
exit 2 (build-failure) so CI surfaces can split the two.
|
|
140
|
+
|
|
141
|
+
The check is **structural**, not semantic — it catches the shapes
|
|
142
|
+
the [`tool-safety`](../../rules/tool-safety.md) rule denies in prose: hidden
|
|
143
|
+
credentials, arbitrary execution, write-without-approval. Fixtures
|
|
144
|
+
and the exit-code-3 contract live in
|
|
145
|
+
[`tests/test_skill_linter_malice.py`](../../../tests/scripts/skill_linter.test.ts).
|
|
146
|
+
|
|
147
|
+
## Confidence Tagging
|
|
148
|
+
|
|
149
|
+
Senior-tier procedure steps MAY append `[CONFIDENCE: high|medium|low]`
|
|
150
|
+
at the end of multi-step chains where the agent's evidence varies
|
|
151
|
+
across steps. Optional but recommended when a step's output feeds a
|
|
152
|
+
downstream decision.
|
|
153
|
+
|
|
154
|
+
Text-tag form is deliberate. Emoji 🟢 / 🟡 / 🔴 is **not** allowed —
|
|
155
|
+
collides with [`direct-answers`](../../rules/direct-answers.md) § Emoji scope
|
|
156
|
+
(functional markers only). Linter does not enforce the tag itself;
|
|
157
|
+
the rule documents the placement so authors converge on one form.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# Source confidentiality — mechanics
|
|
2
|
+
|
|
3
|
+
Migrated out of [`source-confidentiality`](../../rules/source-confidentiality.md)
|
|
4
|
+
on 2026-08-29. The rule is delivered on **every subagent spawn**, so its body is
|
|
5
|
+
paid per spawn; this material is reference read on demand. Nothing was dropped —
|
|
6
|
+
the three sections below are the rule's own text, verbatim, and the rule keeps
|
|
7
|
+
its Iron Laws and points here.
|
|
8
|
+
|
|
9
|
+
### What "source-anonymous" claims, and what it explicitly does not
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
THE CLAIM IS ABOUT WHAT IS WRITTEN NEXT, NEVER ABOUT WHAT IS ALREADY RECORDED.
|
|
13
|
+
NEVER DESCRIBE THIS AS ERADICATION, REMOVAL FROM HISTORY, OR A CLEAN REPOSITORY.
|
|
14
|
+
COMMIT MESSAGES, MERGED PR BODIES AND OLD DIFFS REMAIN RECOVERABLE BY ANYONE
|
|
15
|
+
WITH REPOSITORY ACCESS, AND NO PHASE OF THIS PROGRAMME CHANGES THAT.
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
The `whether-history-gets-rewritten` decision resolved **no rewrite** (AI
|
|
19
|
+
council 2026-08-28, 2/2): the evidence estate rests on stable commit pins, and a
|
|
20
|
+
`git filter-repo` would convert every past `reproduced at <sha>` into an
|
|
21
|
+
unverifiable claim — a larger loss than the residual it removes, and one that
|
|
22
|
+
would still not reach a pre-rewrite clone, a fork or a PR mirror. So the
|
|
23
|
+
residual is **counted, not hidden**: the census artefact
|
|
24
|
+
(`agents/evidence/reports/source-attribution-census.md`) carries a `residual:`
|
|
25
|
+
field for the immutable surfaces, and "clean" always means "clean minus the
|
|
26
|
+
recorded residual".
|
|
27
|
+
|
|
28
|
+
### The two classes are opposites, and only one of them is a leak
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
HARVEST ATTRIBUTION IS PROHIBITED EVERYWHERE.
|
|
32
|
+
LICENSE-REQUIRED ATTRIBUTION IS MANDATORY, AND LIVES ONLY IN THE LICENSE SURFACES.
|
|
33
|
+
CONFLATING THEM IN EITHER DIRECTION IS A DEFECT: SCRUBBING A LICENSE NOTICE
|
|
34
|
+
BREAKS A LEGAL OBLIGATION, AND HIDING A HARVEST BEHIND ONE IS THE LEAK.
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
The three license surfaces, by path — no others:
|
|
38
|
+
|
|
39
|
+
- `CREDITS.md`
|
|
40
|
+
- `docs/THIRD-PARTY-NOTICES.md`
|
|
41
|
+
- `provenance/borrows.jsonl`
|
|
42
|
+
|
|
43
|
+
An upstream name there is required by the license or by
|
|
44
|
+
[`code-provenance`](code-provenance.md) and is never scrubbed. The same name in
|
|
45
|
+
a roadmap, skill, rule, ADR or commit message is harvest attribution and is a
|
|
46
|
+
defect. Every other `skip_paths` entry is a gate-own file or a vendored-cluster
|
|
47
|
+
member carrying its own notice.
|
|
48
|
+
|
|
49
|
+
## The gate also checks SHAPE, not only names
|
|
50
|
+
|
|
51
|
+
A deny list can only catch a name somebody already wrote down; the next unknown
|
|
52
|
+
source walks straight through it. `check_no_external_sources` therefore also
|
|
53
|
+
flags attribution by **form** — a `> **Source:**` header whose value is neither
|
|
54
|
+
an opaque round identifier nor an `ENC1:` token, a quoted
|
|
55
|
+
`agents/tmp(.old)/<name>/` directory whose name is not opaque, and an
|
|
56
|
+
un-allowlisted `github.com/<owner>/<repo>` URL — and it matches tracked **paths**
|
|
57
|
+
against the deny set, not only file contents.
|
|
58
|
+
|
|
59
|
+
Tiering, per the resolved `how-loud-the-slug-heuristic-is` decision (AI council
|
|
60
|
+
2026-08-28, 2/2): **block inside `agents/**`, warn elsewhere** — slugs are
|
|
61
|
+
ordinary content in integration code and docs, where blocking globally would
|
|
62
|
+
drive the broad allowlisting that is worse than the gap it closes. The warn tier
|
|
63
|
+
is written to a retained CI report (`--report <path>`), not merely printed, so
|
|
64
|
+
it stays auditable. Pre-existing occurrences are a **shrink-only count** in
|
|
65
|
+
`src/config/gate-violation-baselines.json`, never an allowlist: nothing is
|
|
66
|
+
excused and a new occurrence fails immediately.
|
|
67
|
+
|
|
68
|
+
## Why these four rules are unconditional
|
|
69
|
+
|
|
70
|
+
Under ADR-236 (`docs/decisions/ADR-236-one-artefact-one-layer.md`) this rule is
|
|
71
|
+
delivered by the PROJECT layer only — it exists to maintain this package, so the
|
|
72
|
+
global layer no longer carries an unscoped twin of it. A `paths:`-scoped rule is
|
|
73
|
+
**not re-injected after `/compact`** (ADR-227:79-80), so scoping it would mean the
|
|
74
|
+
obligation silently disappears mid-session with nothing left to reload it.
|
|
75
|
+
|
|
76
|
+
It is therefore delivered unconditionally, and the path triggers were removed
|
|
77
|
+
rather than worked around. **This section is the shared record for all four such
|
|
78
|
+
rules** — `no-roadmap-references`, `rule-type-governance` and `skill-quality` carry
|
|
79
|
+
the same change and no note of their own. Two reasons: four copies of the rationale
|
|
80
|
+
cost more standing context than the decision they explain, and the other three are
|
|
81
|
+
migrated POINTER stubs held at their pointer's size by
|
|
82
|
+
`check_rule_stub_ceiling` — prose added there is prose in the wrong place by that
|
|
83
|
+
gate's own contract, which is what caught the first attempt to duplicate it.
|
|
84
|
+
|
|
85
|
+
AI council 2026-08-20, 2/2 convergent on this option over three alternatives, with
|
|
86
|
+
two independent decisive arguments. First: the obligation governs an **authoring
|
|
87
|
+
decision**, which happens before any file exists for a path trigger to match — so
|
|
88
|
+
path-scoping fails at greenfield creation whether or not a compaction ever occurs.
|
|
89
|
+
Second: the measured cost is small against what the partition returns. Keeping an
|
|
90
|
+
unscoped global copy was rejected because it re-creates the duplication the
|
|
91
|
+
partition exists to remove; splitting the four by "has a CI gate" was rejected by
|
|
92
|
+
both seats as the wrong axis — a validator observes an outcome, it does not hold an
|
|
93
|
+
obligation during the session, and `rule-type-governance` has no gate at all.
|
|
94
|
+
|
|
95
|
+
**Cost, measured and corrected.** An earlier revision of this note claimed 1,754
|
|
96
|
+
tokens (1.8 % of the partition's 96,584-token saving). That figure was a
|
|
97
|
+
`chars / 4` proxy over the projected files and **understated the real cost by about
|
|
98
|
+
half**: `check_rule_activation_census`, which counts with the exact BPE tokenizer,
|
|
99
|
+
measures the unconditional corpus growing **108,130 → 111,642, i.e. +3,512 tokens
|
|
100
|
+
(3.6 %)** — and that number includes this rationale, which is why it lives in one
|
|
101
|
+
place instead of four. The verdict does not depend on the figure: one seat argued
|
|
102
|
+
the token axis was the wrong one entirely, the other that cost is a legitimate axis
|
|
103
|
+
which simply loses this particular comparison. Both readings survive 3.6 %.
|
|
104
|
+
|
|
105
|
+
## See also
|
|
106
|
+
|
|
107
|
+
- [`source-confidentiality`](../../rules/source-confidentiality.md) — the rule these mechanics belong to.
|
|
108
|
+
- [`code-provenance`](../../rules/code-provenance.md) — the license-required-attribution obligation the two-class split defers to.
|
|
109
|
+
- `src/scripts/check_no_external_sources.ts` — the gate that implements the shape checks.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Symptom-driven harvest loop
|
|
2
|
+
|
|
3
|
+
> The procedure that turns an **operator's production symptom** into a roadmap
|
|
4
|
+
> this repository can execute. It is the inverse of the source-driven harvest:
|
|
5
|
+
> that one starts from external material pushed onto the repo and asks what is
|
|
6
|
+
> worth adopting; this one starts from a failure someone hit in production and
|
|
7
|
+
> pulls external material in **per confirmed defect**.
|
|
8
|
+
>
|
|
9
|
+
> Body of `road-to-symptom-driven-harvest-loop` Phase 2. It lives here rather
|
|
10
|
+
> than inline in [`roadmap-writing`](../../skills/roadmap-writing/SKILL.md)
|
|
11
|
+
> because that skill is already ~4.8k tokens — well past the 3,500-token band —
|
|
12
|
+
> and a procedure needed a few times a quarter should not be paid for on every
|
|
13
|
+
> roadmap-authoring turn. The skill carries the pointer.
|
|
14
|
+
|
|
15
|
+
## When this applies
|
|
16
|
+
|
|
17
|
+
An operator reports a failure in their own words — "runs never end", "the agent
|
|
18
|
+
screenshots instead of reading the code" — rather than a defect with a file and
|
|
19
|
+
a line. File it first under [`agents/tickets/symptoms/`](../../../agents/tickets/symptoms/README.md);
|
|
20
|
+
that entry is what this loop resolves.
|
|
21
|
+
|
|
22
|
+
Not this loop: a defect already traced to a file (that is a roadmap item), a
|
|
23
|
+
feature request (roadmap or ticket), or external material arriving unprompted
|
|
24
|
+
(the source-driven harvest family).
|
|
25
|
+
|
|
26
|
+
## The four steps
|
|
27
|
+
|
|
28
|
+
**1. Confirm against the live tree, at a pinned commit, before any external
|
|
29
|
+
search.** One `file:line` per claim, and the pin recorded next to it. The
|
|
30
|
+
ordering is the load-bearing part: searching externally first produces a plan
|
|
31
|
+
about the ecosystem's problems rather than this tree's, and every subsequent
|
|
32
|
+
round inherits that frame. A symptom that does not reproduce as a confirmed
|
|
33
|
+
defect gets a `null:` block and stops here — that is a result.
|
|
34
|
+
|
|
35
|
+
**2. Triangulate externally, per confirmed defect, never additively.** For each
|
|
36
|
+
defect, and only for each defect: the host tool's own issue tracker, its official
|
|
37
|
+
docs **fetched fresh**, and practitioner reports. Inverted form throughout — the
|
|
38
|
+
defect is the anchor, the source is drawn in to explain or bound it. A source
|
|
39
|
+
that matches no confirmed defect is not evidence for this roadmap; note it and
|
|
40
|
+
drop it.
|
|
41
|
+
|
|
42
|
+
**3. Iterate at least two further rounds, each stating its delta.** A round that
|
|
43
|
+
changes nothing ends the loop early and says so. This is the step that is
|
|
44
|
+
skipped under time pressure and the step that pays: on the first run of this
|
|
45
|
+
loop, round 2 refuted a standing repo blocker from the official payload spec,
|
|
46
|
+
imported a constraint that reshaped a whole phase from "block on invalid" to
|
|
47
|
+
"command-hook, disk-fallback, block-once", and round 3 found a reopen-clause
|
|
48
|
+
deadlock that was the *only* argument for reopening cancelled work at all. A
|
|
49
|
+
one-pass version would have shipped a roadmap re-proposing cancelled items with
|
|
50
|
+
no reopening argument and a mechanism the host would have broken.
|
|
51
|
+
|
|
52
|
+
**4. Emit with a symptom→defect map and per-phase falsifiers.** The map is the
|
|
53
|
+
artifact the operator can read: their words in one column, confirmed defects with
|
|
54
|
+
anchors in the next, owning phase in the third. Every phase carries the
|
|
55
|
+
measurement that would delete it.
|
|
56
|
+
|
|
57
|
+
## Step 5, added by the first three runs: re-verify at adoption
|
|
58
|
+
|
|
59
|
+
A roadmap drafted at a pin and adopted later is a **snapshot of an opinion about
|
|
60
|
+
a tree that has since moved**. Before adopting, re-verify every repo claim at the
|
|
61
|
+
current tip and record the deltas.
|
|
62
|
+
|
|
63
|
+
This is not ceremony. Adopting the first three runs of this loop, 81 commits
|
|
64
|
+
past their shared pin, re-verification found 32 of 36 claims still true — and:
|
|
65
|
+
|
|
66
|
+
- one defect had **fixed itself** (a function measured as having zero production
|
|
67
|
+
callers had acquired one), which deleted a roadmap step before anyone built it;
|
|
68
|
+
- one claim was **wrong at the pin too** (a count stated as six where the tree
|
|
69
|
+
binds seven), which no amount of re-reading the draft would have surfaced;
|
|
70
|
+
- three anchors had **drifted** to new line numbers while their content held;
|
|
71
|
+
- one cross-cutting conflict was invisible until two drafts were read together
|
|
72
|
+
(a proposed "adopt the artifact's code" duty against an existing
|
|
73
|
+
`NEVER ADOPT EXTERNAL CODE VERBATIM` Iron Law).
|
|
74
|
+
|
|
75
|
+
The cheapest of those to find was the already-fixed one, and it was worth the
|
|
76
|
+
most: an item prevented costs nothing to maintain.
|
|
77
|
+
|
|
78
|
+
## Worked example — why round 2 is mandatory
|
|
79
|
+
|
|
80
|
+
`hook_manifest.yaml` carried a comment stating that in-process subagents "inherit
|
|
81
|
+
the host process env and cannot be marked per-spawn", and that comment had stood
|
|
82
|
+
for months as a recorded blocker on a whole design axis. It was true about the
|
|
83
|
+
mechanism it named — the env var — and false about the conclusion.
|
|
84
|
+
|
|
85
|
+
Round 2 fetched the host's current payload specification, which states that tool
|
|
86
|
+
events inside a subagent carry `agent_id` and `agent_type` precisely so
|
|
87
|
+
subagent calls can be distinguished from main-thread ones. The env cannot mark a
|
|
88
|
+
spawn; the payload already did. One fetch refuted a months-old blocker, and the
|
|
89
|
+
axis it had closed reopened.
|
|
90
|
+
|
|
91
|
+
The general shape: **a repo comment records what was tried, not what is
|
|
92
|
+
possible.** Round 1 finds the comment and believes it, because it is this tree's
|
|
93
|
+
own evidence. Only an external round can date it.
|
|
94
|
+
|
|
95
|
+
## See also
|
|
96
|
+
|
|
97
|
+
- [`roadmap-writing`](../../skills/roadmap-writing/SKILL.md) — the authoring
|
|
98
|
+
skill this procedure extends; it owns phases, falsifiers, and the output format.
|
|
99
|
+
- [`agents/tickets/symptoms/README.md`](../../../agents/tickets/symptoms/README.md) —
|
|
100
|
+
the intake convention and the two resolution blocks.
|
|
101
|
+
- [`source-discovery-gate`](../../rules/source-discovery-gate.md) — the
|
|
102
|
+
no-structural-claim-without-evidence rule step 1 is an application of.
|
|
103
|
+
- [`external-reference-deep-dive`](../../rules/external-reference-deep-dive.md) —
|
|
104
|
+
how to read a named external source properly in step 2.
|