@rosetears/aili-pi 0.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/LICENSE +21 -0
- package/README.md +109 -0
- package/THIRD_PARTY_NOTICES.md +64 -0
- package/extensions/index.ts +6 -0
- package/install.sh +5 -0
- package/manifests/adapter-evidence.json +45 -0
- package/manifests/capabilities.json +124 -0
- package/manifests/live-verification.json +26 -0
- package/manifests/provenance.json +71 -0
- package/manifests/roles.json +474 -0
- package/manifests/sbom.json +7797 -0
- package/manifests/skill-compatibility.json +8100 -0
- package/manifests/subagent-provenance.json +37 -0
- package/package.json +91 -0
- package/prompts/build.md +8 -0
- package/prompts/define.md +8 -0
- package/prompts/ideate.md +8 -0
- package/prompts/local-review.md +8 -0
- package/prompts/ship.md +8 -0
- package/roles/agent-evaluator.md +47 -0
- package/roles/ai-regression-scout.md +47 -0
- package/roles/browser-qa-runner.md +47 -0
- package/roles/code-reviewer.md +47 -0
- package/roles/code-scout.md +47 -0
- package/roles/convergence-reviewer.md +55 -0
- package/roles/doc-researcher.md +47 -0
- package/roles/e2e-artifact-runner.md +47 -0
- package/roles/implementer.md +47 -0
- package/roles/opensource-sanitizer.md +47 -0
- package/roles/plan-auditor.md +47 -0
- package/roles/pr-test-analyzer.md +47 -0
- package/roles/security-auditor.md +47 -0
- package/roles/silent-failure-reviewer.md +47 -0
- package/roles/spec-miner.md +47 -0
- package/roles/test-coverage-reviewer.md +47 -0
- package/roles/test-engineer.md +48 -0
- package/roles/web-performance-auditor.md +47 -0
- package/roles/web-researcher.md +47 -0
- package/scripts/apply-adapter-evidence.ts +73 -0
- package/scripts/bootstrap.sh +180 -0
- package/scripts/generate-provenance.ts +143 -0
- package/scripts/local-package-e2e.ts +51 -0
- package/scripts/sync-roles.ts +213 -0
- package/scripts/sync-skills.ts +356 -0
- package/scripts/validate-runtime.ts +11 -0
- package/skills/academic-paper-review/SKILL.md +81 -0
- package/skills/agents-md-initialization/SKILL.md +121 -0
- package/skills/agents-md-initialization/references/agents-template.md +83 -0
- package/skills/agents-md-initialization/references/agents_md.py +215 -0
- package/skills/ai-regression-scout/SKILL.md +24 -0
- package/skills/aili-delivery-flow/SKILL.md +125 -0
- package/skills/aili-delivery-flow/references/artifact-contracts.md +138 -0
- package/skills/aili-delivery-flow/references/backend-routing.md +40 -0
- package/skills/aili-delivery-flow/references/build-execution-loop.md +113 -0
- package/skills/aili-delivery-flow/references/build-goal-mode.md +3 -0
- package/skills/aili-delivery-flow/references/direct-vs-delegated-work.md +38 -0
- package/skills/aili-delivery-flow/references/implementation-packages.md +54 -0
- package/skills/aili-delivery-flow/references/lifecycle.md +127 -0
- package/skills/aili-delivery-flow/references/protocols/acceptance-test-plan.md +18 -0
- package/skills/aili-delivery-flow/references/protocols/alignment-questionnaire.md +10 -0
- package/skills/aili-delivery-flow/references/protocols/closeout-report.md +101 -0
- package/skills/aili-delivery-flow/references/protocols/compact-evidence-pack.md +46 -0
- package/skills/aili-delivery-flow/references/protocols/idea-brief.md +10 -0
- package/skills/aili-delivery-flow/references/protocols/implementation-package.md +53 -0
- package/skills/aili-delivery-flow/references/protocols/research-evidence-pack.md +19 -0
- package/skills/aili-delivery-flow/references/protocols/review-report.md +7 -0
- package/skills/aili-delivery-flow/references/protocols/spec-draft.md +12 -0
- package/skills/aili-delivery-flow/references/protocols/subagent-result.md +60 -0
- package/skills/aili-delivery-flow/references/protocols/subagent-task-packet.md +29 -0
- package/skills/aili-delivery-flow/references/protocols/worktree-context.md +109 -0
- package/skills/aili-delivery-flow/references/questionnaire-policy.md +62 -0
- package/skills/aili-delivery-flow/references/review-repair-loop.md +16 -0
- package/skills/aili-delivery-flow/references/test-document-policy.md +35 -0
- package/skills/android-native-dev/SKILL.md +722 -0
- package/skills/android-native-dev/references/accessibility.md +209 -0
- package/skills/android-native-dev/references/adaptive-screens.md +231 -0
- package/skills/android-native-dev/references/design-style-guide.md +365 -0
- package/skills/android-native-dev/references/functional-requirements.md +229 -0
- package/skills/android-native-dev/references/motion-system.md +203 -0
- package/skills/android-native-dev/references/performance-stability.md +223 -0
- package/skills/android-native-dev/references/privacy-security.md +244 -0
- package/skills/android-native-dev/references/testing.md +554 -0
- package/skills/android-native-dev/references/visual-design.md +246 -0
- package/skills/api-and-interface-design/SKILL.md +318 -0
- package/skills/browser-qa/SKILL.md +32 -0
- package/skills/browser-testing-with-devtools/SKILL.md +323 -0
- package/skills/build-failure-repair/SKILL.md +49 -0
- package/skills/chart-visualization/SKILL.md +73 -0
- package/skills/ci-cd-and-automation/SKILL.md +353 -0
- package/skills/code-review-and-quality/SKILL.md +375 -0
- package/skills/code-review-quality-gates/SKILL.md +132 -0
- package/skills/code-simplification/SKILL.md +371 -0
- package/skills/comment-accuracy-review/SKILL.md +37 -0
- package/skills/consulting-analysis/SKILL.md +69 -0
- package/skills/context-engineering/SKILL.md +375 -0
- package/skills/coverage-review/SKILL.md +24 -0
- package/skills/data-analysis/SKILL.md +74 -0
- package/skills/deprecation-and-migration/SKILL.md +222 -0
- package/skills/documentation-and-adrs/SKILL.md +330 -0
- package/skills/e2e-artifact-handling/SKILL.md +30 -0
- package/skills/evidence-scoped-retrospective/SKILL.md +156 -0
- package/skills/explain-by-allegory/SKILL.md +99 -0
- package/skills/flutter-dev/SKILL.md +162 -0
- package/skills/flutter-dev/references/animations.md +497 -0
- package/skills/flutter-dev/references/bloc-state.md +281 -0
- package/skills/flutter-dev/references/forms.md +656 -0
- package/skills/flutter-dev/references/gorouter-navigation.md +257 -0
- package/skills/flutter-dev/references/localization.md +510 -0
- package/skills/flutter-dev/references/networking.md +566 -0
- package/skills/flutter-dev/references/performance.md +305 -0
- package/skills/flutter-dev/references/platform-specific.md +417 -0
- package/skills/flutter-dev/references/project-structure.md +273 -0
- package/skills/flutter-dev/references/riverpod-state.md +232 -0
- package/skills/flutter-dev/references/testing.md +364 -0
- package/skills/flutter-dev/references/widget-patterns.md +233 -0
- package/skills/frontend-dev/SKILL.md +468 -0
- package/skills/frontend-dev/canvas-fonts/ArsenalSC-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/BigShoulders-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/BigShoulders-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/BigShoulders-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Boldonse-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Boldonse-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/CrimsonPro-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/DMMono-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/DMMono-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/EricaOne-OFL.txt +94 -0
- package/skills/frontend-dev/canvas-fonts/EricaOne-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/GeistMono-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/GeistMono-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/GeistMono-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Gloock-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Gloock-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSans-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Italiana-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Italiana-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Jura-Light.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Jura-Medium.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Jura-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Lora-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Lora-BoldItalic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Lora-Italic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Lora-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Lora-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/NationalPark-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/NationalPark-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/NationalPark-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Outfit-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Outfit-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Outfit-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/PixelifySans-Medium.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/PixelifySans-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/PoiretOne-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/PoiretOne-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/RedHatMono-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/RedHatMono-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/RedHatMono-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Silkscreen-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Silkscreen-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/SmoochSans-Medium.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/SmoochSans-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Tektur-Medium.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/Tektur-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/Tektur-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/WorkSans-Bold.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/WorkSans-Italic.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/WorkSans-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/WorkSans-Regular.ttf +0 -0
- package/skills/frontend-dev/canvas-fonts/YoungSerif-OFL.txt +93 -0
- package/skills/frontend-dev/canvas-fonts/YoungSerif-Regular.ttf +0 -0
- package/skills/frontend-dev/references/asset-prompt-guide.md +43 -0
- package/skills/frontend-dev/references/env-setup.md +33 -0
- package/skills/frontend-dev/references/minimax-cli-reference.md +133 -0
- package/skills/frontend-dev/references/minimax-image-guide.md +65 -0
- package/skills/frontend-dev/references/minimax-music-guide.md +216 -0
- package/skills/frontend-dev/references/minimax-tts-guide.md +78 -0
- package/skills/frontend-dev/references/minimax-video-guide.md +82 -0
- package/skills/frontend-dev/references/minimax-voice-catalog.md +685 -0
- package/skills/frontend-dev/references/motion-recipes.md +407 -0
- package/skills/frontend-dev/references/troubleshooting.md +85 -0
- package/skills/frontend-dev/scripts/minimax_image.py +137 -0
- package/skills/frontend-dev/scripts/minimax_music.py +157 -0
- package/skills/frontend-dev/scripts/minimax_tts.py +127 -0
- package/skills/frontend-dev/scripts/minimax_video.py +187 -0
- package/skills/frontend-dev/templates/generator_template.js +223 -0
- package/skills/frontend-dev/templates/viewer.html +599 -0
- package/skills/frontend-ui-engineering/SKILL.md +367 -0
- package/skills/fullstack-dev/SKILL.md +819 -0
- package/skills/fullstack-dev/references/api-design.md +444 -0
- package/skills/fullstack-dev/references/auth-flow.md +165 -0
- package/skills/fullstack-dev/references/db-schema.md +706 -0
- package/skills/fullstack-dev/references/django-best-practices.md +466 -0
- package/skills/fullstack-dev/references/environment-management.md +78 -0
- package/skills/fullstack-dev/references/release-checklist.md +278 -0
- package/skills/fullstack-dev/references/technology-selection.md +254 -0
- package/skills/fullstack-dev/references/testing-strategy.md +404 -0
- package/skills/git-workflow-and-versioning/SKILL.md +446 -0
- package/skills/github-evidence-triage/SKILL.md +115 -0
- package/skills/harness-evolution/SKILL.md +59 -0
- package/skills/harness-evolution/references/activation-matrix.md +13 -0
- package/skills/harness-evolution/references/approval-policy.md +20 -0
- package/skills/harness-evolution/references/change-report-template.md +33 -0
- package/skills/harness-evolution/references/component-taxonomy.md +19 -0
- package/skills/harness-evolution/references/verdict-policy.md +13 -0
- package/skills/harness-issue-triage/SKILL.md +72 -0
- package/skills/harness-issue-triage/references/component-diagnosis.md +25 -0
- package/skills/harness-issue-triage/references/triage-report-template.md +34 -0
- package/skills/harness-optimization-audit/SKILL.md +125 -0
- package/skills/idea-refine/SKILL.md +191 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/LICENSE +21 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/NOTICE.md +9 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/idea-refine/SKILL.upstream.md +178 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/idea-refine/examples.md +238 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/idea-refine/frameworks.md +99 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/idea-refine/refinement-criteria.md +113 -0
- package/skills/idea-refine/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/idea-refine/scripts/idea-refine.upstream.sh +15 -0
- package/skills/incremental-implementation/SKILL.md +252 -0
- package/skills/ios-application-dev/SKILL.md +212 -0
- package/skills/ios-application-dev/references/accessibility.md +259 -0
- package/skills/ios-application-dev/references/graphics-animation.md +350 -0
- package/skills/ios-application-dev/references/layout-system.md +199 -0
- package/skills/ios-application-dev/references/metal-shader.md +178 -0
- package/skills/ios-application-dev/references/navigation-patterns.md +175 -0
- package/skills/ios-application-dev/references/swift-coding-standards.md +757 -0
- package/skills/ios-application-dev/references/swiftui-design-guidelines.md +1167 -0
- package/skills/ios-application-dev/references/system-integration.md +401 -0
- package/skills/ios-application-dev/references/uikit-components.md +297 -0
- package/skills/local-review-gate/SKILL.md +207 -0
- package/skills/local-review-gate/references/addyosmani-code-review-rubric.md +33 -0
- package/skills/local-review-gate/references/codex-github-compatibility.md +26 -0
- package/skills/local-review-gate/references/ecc-code-review-adaptation.md +40 -0
- package/skills/local-review-gate/references/graphify-local-review.md +33 -0
- package/skills/local-review-gate/references/orchestration-adaptation.md +51 -0
- package/skills/local-review-gate/references/review-repair-lane-adaptation.md +46 -0
- package/skills/local-review-gate/references/upstream-provenance.md +61 -0
- package/skills/mature-project-pattern-research/SKILL.md +155 -0
- package/skills/mature-project-pattern-research/references/research-rubric.md +45 -0
- package/skills/minimax-docx/LICENSE +21 -0
- package/skills/minimax-docx/SKILL.md +273 -0
- package/skills/minimax-docx/assets/styles/academic_styles.xml +250 -0
- package/skills/minimax-docx/assets/styles/corporate_styles.xml +284 -0
- package/skills/minimax-docx/assets/styles/default_styles.xml +449 -0
- package/skills/minimax-docx/assets/xsd/aesthetic-rules.xsd +470 -0
- package/skills/minimax-docx/assets/xsd/business-rules.xsd +130 -0
- package/skills/minimax-docx/assets/xsd/common-types.xsd +159 -0
- package/skills/minimax-docx/assets/xsd/wml-subset.xsd +589 -0
- package/skills/minimax-docx/references/cjk_typography.md +357 -0
- package/skills/minimax-docx/references/cjk_university_template_guide.md +184 -0
- package/skills/minimax-docx/references/comments_guide.md +191 -0
- package/skills/minimax-docx/references/design_good_bad_examples.md +829 -0
- package/skills/minimax-docx/references/design_principles.md +819 -0
- package/skills/minimax-docx/references/openxml_element_order.md +308 -0
- package/skills/minimax-docx/references/openxml_encyclopedia_part1.md +4061 -0
- package/skills/minimax-docx/references/openxml_encyclopedia_part2.md +2820 -0
- package/skills/minimax-docx/references/openxml_encyclopedia_part3.md +3381 -0
- package/skills/minimax-docx/references/openxml_namespaces.md +82 -0
- package/skills/minimax-docx/references/openxml_units.md +72 -0
- package/skills/minimax-docx/references/scenario_a_create.md +284 -0
- package/skills/minimax-docx/references/scenario_b_edit_content.md +295 -0
- package/skills/minimax-docx/references/scenario_c_apply_template.md +456 -0
- package/skills/minimax-docx/references/track_changes_guide.md +200 -0
- package/skills/minimax-docx/references/troubleshooting.md +506 -0
- package/skills/minimax-docx/references/typography_guide.md +294 -0
- package/skills/minimax-docx/references/xsd_validation_guide.md +158 -0
- package/skills/minimax-docx/scripts/doc_to_docx.sh +40 -0
- package/skills/minimax-docx/scripts/docx_preview.sh +37 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Cli/MiniMaxAIDocx.Cli.csproj +19 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Cli/Program.cs +18 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/CreateCommand.cs +324 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/DiffCommand.cs +155 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/EditContentCommand.cs +487 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/ValidateCommand.cs +107 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/MiniMaxAIDocx.Core.csproj +15 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/RunMerger.cs +81 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ImageSamples.cs +917 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/TableSamples.cs +1163 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/CjkHelper.cs +39 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/FontDefaults.cs +24 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/PageSizes.cs +20 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/ValidationResult.cs +23 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/XsdValidator.cs +69 -0
- package/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.slnx +4 -0
- package/skills/minimax-docx/scripts/env_check.sh +196 -0
- package/skills/minimax-docx/scripts/setup.ps1 +274 -0
- package/skills/minimax-docx/scripts/setup.sh +504 -0
- package/skills/minimax-pdf/README.md +222 -0
- package/skills/minimax-pdf/SKILL.md +218 -0
- package/skills/minimax-pdf/design/design.md +381 -0
- package/skills/minimax-pdf/scripts/cover.py +1579 -0
- package/skills/minimax-pdf/scripts/fill_inspect.py +200 -0
- package/skills/minimax-pdf/scripts/fill_write.py +242 -0
- package/skills/minimax-pdf/scripts/make.sh +491 -0
- package/skills/minimax-pdf/scripts/merge.py +112 -0
- package/skills/minimax-pdf/scripts/palette.py +521 -0
- package/skills/minimax-pdf/scripts/reformat_parse.py +374 -0
- package/skills/minimax-pdf/scripts/render_body.py +1052 -0
- package/skills/minimax-pdf/scripts/render_cover.js +111 -0
- package/skills/minimax-xlsx/SKILL.md +156 -0
- package/skills/minimax-xlsx/references/create.md +691 -0
- package/skills/minimax-xlsx/references/edit.md +684 -0
- package/skills/minimax-xlsx/references/fix.md +37 -0
- package/skills/minimax-xlsx/references/format.md +768 -0
- package/skills/minimax-xlsx/references/ooxml-cheatsheet.md +231 -0
- package/skills/minimax-xlsx/references/read-analyze.md +97 -0
- package/skills/minimax-xlsx/references/validate.md +772 -0
- package/skills/minimax-xlsx/scripts/formula_check.py +422 -0
- package/skills/minimax-xlsx/scripts/libreoffice_recalc.py +248 -0
- package/skills/minimax-xlsx/scripts/shared_strings_builder.py +163 -0
- package/skills/minimax-xlsx/scripts/style_audit.py +575 -0
- package/skills/minimax-xlsx/scripts/xlsx_add_column.py +395 -0
- package/skills/minimax-xlsx/scripts/xlsx_insert_row.py +274 -0
- package/skills/minimax-xlsx/scripts/xlsx_pack.py +87 -0
- package/skills/minimax-xlsx/scripts/xlsx_reader.py +362 -0
- package/skills/minimax-xlsx/scripts/xlsx_shift_rows.py +396 -0
- package/skills/minimax-xlsx/scripts/xlsx_unpack.py +130 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/[Content_Types].xml +9 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/_rels/.rels +6 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/xl/_rels/workbook.xml.rels +19 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/xl/sharedStrings.xml +33 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/xl/styles.xml +160 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/xl/workbook.xml +30 -0
- package/skills/minimax-xlsx/templates/minimal_xlsx/xl/worksheets/sheet1.xml +70 -0
- package/skills/newsletter-generation/SKILL.md +71 -0
- package/skills/oss-release-readiness/SKILL.md +47 -0
- package/skills/parallel-subagent-dispatch/SKILL.md +58 -0
- package/skills/performance-optimization/SKILL.md +364 -0
- package/skills/planning-and-task-breakdown/SKILL.md +290 -0
- package/skills/pptx-generator/SKILL.md +275 -0
- package/skills/pptx-generator/references/design-system.md +392 -0
- package/skills/pptx-generator/references/editing.md +162 -0
- package/skills/pptx-generator/references/pitfalls.md +112 -0
- package/skills/pptx-generator/references/pptxgenjs.md +420 -0
- package/skills/pptx-generator/references/slide-types.md +413 -0
- package/skills/pr-test-analysis/SKILL.md +24 -0
- package/skills/react-native-dev/SKILL.md +180 -0
- package/skills/react-native-dev/references/animations.md +254 -0
- package/skills/react-native-dev/references/components.md +124 -0
- package/skills/react-native-dev/references/engineering.md +527 -0
- package/skills/react-native-dev/references/forms.md +300 -0
- package/skills/react-native-dev/references/native-capabilities.md +163 -0
- package/skills/react-native-dev/references/navigation.md +271 -0
- package/skills/react-native-dev/references/networking.md +346 -0
- package/skills/react-native-dev/references/performance.md +215 -0
- package/skills/react-native-dev/references/state-management.md +230 -0
- package/skills/react-native-dev/references/styling.md +117 -0
- package/skills/react-native-dev/references/testing.md +341 -0
- package/skills/requirements-grilling/SKILL.md +447 -0
- package/skills/requirements-grilling/references/ADR-FORMAT.md +46 -0
- package/skills/requirements-grilling/references/CONTEXT-FORMAT.md +41 -0
- package/skills/requirements-grilling/references/INTERVIEW-PACKET-FORMAT.md +62 -0
- package/skills/requirements-grilling/references/MIT-LICENSE-MATT-POCOCK.md +25 -0
- package/skills/requirements-grilling/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/LICENSE +21 -0
- package/skills/requirements-grilling/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/NOTICE.md +9 -0
- package/skills/requirements-grilling/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/interview-me/SKILL.upstream.md +225 -0
- package/skills/requirements-grilling/references/upstream/mattpocock-skills/9603c1cc8118d08bc1b3bf34cf714f62178dea3b/LICENSE +21 -0
- package/skills/requirements-grilling/references/upstream/mattpocock-skills/9603c1cc8118d08bc1b3bf34cf714f62178dea3b/NOTICE.md +12 -0
- package/skills/requirements-grilling/references/upstream/mattpocock-skills/9603c1cc8118d08bc1b3bf34cf714f62178dea3b/batch-grill-me/SKILL.upstream.md +15 -0
- package/skills/requirements-grilling/references/upstream/mattpocock-skills/9603c1cc8118d08bc1b3bf34cf714f62178dea3b/grill-me/SKILL.upstream.md +7 -0
- package/skills/requirements-grilling/references/upstream/mattpocock-skills/9603c1cc8118d08bc1b3bf34cf714f62178dea3b/grilling/SKILL.upstream.md +12 -0
- package/skills/review-pipeline/SKILL.md +38 -0
- package/skills/rose-memory/SKILL.md +210 -0
- package/skills/rose-memory/references/README.md +48 -0
- package/skills/rose-memory/references/memory_cli.py +2384 -0
- package/skills/rose-memory/references/schema.sql +315 -0
- package/skills/security-and-hardening/SKILL.md +369 -0
- package/skills/session-handoff/SKILL.md +88 -0
- package/skills/session-handoff/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/LICENSE +21 -0
- package/skills/session-handoff/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/NOTICE.md +9 -0
- package/skills/session-handoff/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/productivity/handoff/SKILL.upstream.md +16 -0
- package/skills/session-handoff/scripts/session_handoff.py +764 -0
- package/skills/shader-dev/SKILL.md +316 -0
- package/skills/shader-dev/reference/ambient-occlusion.md +382 -0
- package/skills/shader-dev/reference/analytic-ray-tracing.md +651 -0
- package/skills/shader-dev/reference/anti-aliasing.md +71 -0
- package/skills/shader-dev/reference/atmospheric-scattering.md +571 -0
- package/skills/shader-dev/reference/camera-effects.md +80 -0
- package/skills/shader-dev/reference/cellular-automata.md +635 -0
- package/skills/shader-dev/reference/color-palette.md +481 -0
- package/skills/shader-dev/reference/csg-boolean-operations.md +466 -0
- package/skills/shader-dev/reference/domain-repetition.md +436 -0
- package/skills/shader-dev/reference/domain-warping.md +419 -0
- package/skills/shader-dev/reference/fluid-simulation.md +425 -0
- package/skills/shader-dev/reference/fractal-rendering.md +525 -0
- package/skills/shader-dev/reference/lighting-model.md +639 -0
- package/skills/shader-dev/reference/matrix-transform.md +535 -0
- package/skills/shader-dev/reference/multipass-buffer.md +571 -0
- package/skills/shader-dev/reference/normal-estimation.md +418 -0
- package/skills/shader-dev/reference/particle-system.md +589 -0
- package/skills/shader-dev/reference/path-tracing-gi.md +602 -0
- package/skills/shader-dev/reference/polar-uv-manipulation.md +521 -0
- package/skills/shader-dev/reference/post-processing.md +375 -0
- package/skills/shader-dev/reference/procedural-2d-pattern.md +439 -0
- package/skills/shader-dev/reference/procedural-noise.md +551 -0
- package/skills/shader-dev/reference/ray-marching.md +396 -0
- package/skills/shader-dev/reference/sdf-2d.md +724 -0
- package/skills/shader-dev/reference/sdf-3d.md +805 -0
- package/skills/shader-dev/reference/sdf-tricks.md +63 -0
- package/skills/shader-dev/reference/shadow-techniques.md +476 -0
- package/skills/shader-dev/reference/simulation-physics.md +644 -0
- package/skills/shader-dev/reference/sound-synthesis.md +578 -0
- package/skills/shader-dev/reference/terrain-rendering.md +839 -0
- package/skills/shader-dev/reference/texture-mapping-advanced.md +87 -0
- package/skills/shader-dev/reference/texture-sampling.md +553 -0
- package/skills/shader-dev/reference/volumetric-rendering.md +608 -0
- package/skills/shader-dev/reference/voronoi-cellular-noise.md +486 -0
- package/skills/shader-dev/reference/voxel-rendering.md +701 -0
- package/skills/shader-dev/reference/water-ocean.md +445 -0
- package/skills/shader-dev/reference/webgl-pitfalls.md +41 -0
- package/skills/shader-dev/techniques/ambient-occlusion.md +364 -0
- package/skills/shader-dev/techniques/analytic-ray-tracing.md +542 -0
- package/skills/shader-dev/techniques/anti-aliasing.md +124 -0
- package/skills/shader-dev/techniques/atmospheric-scattering.md +522 -0
- package/skills/shader-dev/techniques/camera-effects.md +115 -0
- package/skills/shader-dev/techniques/cellular-automata.md +531 -0
- package/skills/shader-dev/techniques/color-palette.md +380 -0
- package/skills/shader-dev/techniques/csg-boolean-operations.md +491 -0
- package/skills/shader-dev/techniques/domain-repetition.md +333 -0
- package/skills/shader-dev/techniques/domain-warping.md +414 -0
- package/skills/shader-dev/techniques/fluid-simulation.md +1175 -0
- package/skills/shader-dev/techniques/fractal-rendering.md +436 -0
- package/skills/shader-dev/techniques/lighting-model.md +527 -0
- package/skills/shader-dev/techniques/matrix-transform.md +455 -0
- package/skills/shader-dev/techniques/multipass-buffer.md +922 -0
- package/skills/shader-dev/techniques/normal-estimation.md +318 -0
- package/skills/shader-dev/techniques/particle-system.md +1203 -0
- package/skills/shader-dev/techniques/path-tracing-gi.md +623 -0
- package/skills/shader-dev/techniques/polar-uv-manipulation.md +373 -0
- package/skills/shader-dev/techniques/post-processing.md +788 -0
- package/skills/shader-dev/techniques/procedural-2d-pattern.md +346 -0
- package/skills/shader-dev/techniques/procedural-noise.md +554 -0
- package/skills/shader-dev/techniques/ray-marching.md +467 -0
- package/skills/shader-dev/techniques/sdf-2d.md +631 -0
- package/skills/shader-dev/techniques/sdf-3d.md +589 -0
- package/skills/shader-dev/techniques/sdf-tricks.md +100 -0
- package/skills/shader-dev/techniques/shadow-techniques.md +776 -0
- package/skills/shader-dev/techniques/simulation-physics.md +1542 -0
- package/skills/shader-dev/techniques/sound-synthesis.md +490 -0
- package/skills/shader-dev/techniques/terrain-rendering.md +408 -0
- package/skills/shader-dev/techniques/texture-mapping-advanced.md +121 -0
- package/skills/shader-dev/techniques/texture-sampling.md +382 -0
- package/skills/shader-dev/techniques/volumetric-rendering.md +375 -0
- package/skills/shader-dev/techniques/voronoi-cellular-noise.md +458 -0
- package/skills/shader-dev/techniques/voxel-rendering.md +985 -0
- package/skills/shader-dev/techniques/water-ocean.md +490 -0
- package/skills/shader-dev/techniques/webgl-pitfalls.md +170 -0
- package/skills/shipping-and-launch/SKILL.md +334 -0
- package/skills/silent-failure-hunting/SKILL.md +24 -0
- package/skills/source-driven-development/SKILL.md +223 -0
- package/skills/spec-driven-development/SKILL.md +235 -0
- package/skills/spec-driven-development/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/LICENSE +21 -0
- package/skills/spec-driven-development/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/NOTICE.md +9 -0
- package/skills/spec-driven-development/references/upstream/addyosmani-agent-skills/6bcfeb9dae52b11eaad23511acc165109746dbc3/spec-driven-development/SKILL.upstream.md +206 -0
- package/skills/strategy-stress-test/SKILL.md +185 -0
- package/skills/systematic-literature-review/SKILL.md +77 -0
- package/skills/test-document-generator/SKILL.md +152 -0
- package/skills/test-document-generator/references/test-document-template.md +45 -0
- package/skills/test-driven-development/SKILL.md +399 -0
- package/skills/write-skills/GLOSSARY.md +113 -0
- package/skills/write-skills/SKILL.md +133 -0
- package/skills/write-skills/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/LICENSE +21 -0
- package/skills/write-skills/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/NOTICE.md +9 -0
- package/skills/write-skills/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/productivity/writing-great-skills/GLOSSARY.md +201 -0
- package/skills/write-skills/references/upstream/mattpocock-skills/391a2701dd948f94f56a39f7533f8eea9a859c87/productivity/writing-great-skills/SKILL.upstream.md +83 -0
- package/src/runtime/child-guard.ts +70 -0
- package/src/runtime/conflicts.ts +25 -0
- package/src/runtime/contracts.ts +9 -0
- package/src/runtime/doctor.ts +134 -0
- package/src/runtime/global-resources.ts +152 -0
- package/src/runtime/index.ts +23 -0
- package/src/runtime/lifecycle.ts +19 -0
- package/src/runtime/native-integrations.ts +44 -0
- package/src/runtime/path-boundaries.ts +69 -0
- package/src/runtime/registry.ts +213 -0
- package/src/runtime/roles.ts +64 -0
- package/src/runtime/rose-context.ts +24 -0
- package/src/runtime/subagents.ts +426 -0
- package/templates/APPEND_SYSTEM.md +12 -0
- package/upstream/aili-workflows.lock.json +3226 -0
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spec-driven-development
|
|
3
|
+
description: Create or materially revise a durable specification when the user explicitly requests a spec/new feature contract or a named ambiguity requires formal DEFINE; do not trigger for ordinary bounded edits, implementation, task breakdown alone, review, or documentation of already-settled behavior.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Spec-Driven Development
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
When explicit specification intent or a material ambiguity selects this loop, create the smallest durable contract that defines scope, behavior, boundaries, and acceptance. Ordinary bounded work remains outside this skill and does not require a new formal specification.
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
- The user explicitly asks for a specification or formal feature/change contract.
|
|
15
|
+
- A named material ambiguity requires durable scope, behavior, interface, or acceptance decisions before implementation.
|
|
16
|
+
- A new project/feature has no current formal contract and the ordinary/formal classifier selects DEFINE.
|
|
17
|
+
|
|
18
|
+
**When NOT to use:** Ordinary bounded edits, multi-file work with clear acceptance, task breakdown from an existing spec, implementation, review, or docs-only explanation.
|
|
19
|
+
|
|
20
|
+
## Canonical loop contract
|
|
21
|
+
|
|
22
|
+
This skill is a bounded adapter to the ordinary specification or canonical DEFINE loop. ROSE/`aili-delivery-flow` owns change identity, lifecycle state, approvals, progress, and verification. Produce only the next dependency-ready spec artifacts, reread each write once, and stop with `complete`, `need-user`, `need-evidence`, `material-delta`, `blocked`, or `Unverified`. Do not invoke planning, requirements, research, test-plan, TDD, implementation, review, or another process skill. Return a named need to ROSE. Lifecycle approval and claim-matched verification rules override generic upstream phase/checklist wording.
|
|
23
|
+
|
|
24
|
+
## The Validated Workflow
|
|
25
|
+
|
|
26
|
+
Spec-driven development supplies SPECIFY/PLAN/TASKS techniques. Formal AILI work maps them to dependency-ready canonical artifacts through `aili-delivery-flow`; it does not own IMPLEMENT, create upstream task files, public commands, or parallel approval authorities.
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
SPECIFY ──→ PLAN ──→ TASKS ──→ HANDOFF
|
|
30
|
+
│ │ │ │
|
|
31
|
+
▼ ▼ ▼ ▼
|
|
32
|
+
Validate Validate Validate Return to owner
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
🔴 **CHECKPOINT · AILI lifecycle gate:** phase validation may require clarification or revision, but is not a separate mandatory lifecycle approval. Resolve or label material `Open Question` / `Unverified` items, persist/re-read canonical artifacts, and preserve final accepted `test-plan.md` as the sole mandatory pre-BUILD user approval. Silence, inferred intent, drafts, and upstream phase language are never approval.
|
|
36
|
+
|
|
37
|
+
The pinned Addy file under `references/upstream/` is inert reference data. This existing skill is the only runnable adapter; AILI placement, permissions, lifecycle order, material-delta writeback, final test-plan acceptance, and stop conditions override foreign paths and gates.
|
|
38
|
+
|
|
39
|
+
### Phase 1: Specify
|
|
40
|
+
|
|
41
|
+
Within the selected specification loop, start with the current objective and ask only decision-shaped questions needed to make material requirements concrete.
|
|
42
|
+
|
|
43
|
+
**Surface assumptions immediately.** Before writing any spec content, list what you're assuming:
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
ASSUMPTIONS I'M MAKING:
|
|
47
|
+
1. This is a web application (not native mobile)
|
|
48
|
+
2. Authentication uses session-based cookies (not JWT)
|
|
49
|
+
3. The database is PostgreSQL (based on existing Prisma schema)
|
|
50
|
+
4. We're targeting modern browsers only (no IE11)
|
|
51
|
+
→ Material assumptions require an explicit decision; otherwise they remain Open Question and block affected work.
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Don't silently fill in ambiguous requirements. The spec's entire purpose is to surface misunderstandings *before* code gets written — assumptions are the most dangerous form of misunderstanding.
|
|
55
|
+
|
|
56
|
+
### Ambiguity Fallbacks
|
|
57
|
+
|
|
58
|
+
| Trigger condition | First response | If still unresolved |
|
|
59
|
+
|---|---|---|
|
|
60
|
+
| User asks for a broad feature with no success criteria | Draft 2-4 concrete success criteria and return the decision to ROSE | Keep the item as `Open Question`; do not proceed to PLAN |
|
|
61
|
+
| Architecture, data model, security, or migration behavior is unclear | List the competing options and tradeoffs for ROSE | Return `need-user` or `material-delta`; stop before implementation |
|
|
62
|
+
| Existing code/docs conflict with the user's description | Cite the conflict and return the source-of-truth decision to ROSE | Mark the conflict `Unverified`; do not choose silently |
|
|
63
|
+
| The spec would require public API, dependency, schema, or deployment changes | Return the exact material/risky decision or operation to ROSE | Block implementation tasks until the canonical approval is recorded |
|
|
64
|
+
|
|
65
|
+
Use only the sections needed by the current specification. Objective/success and material boundaries are normally required; commands, structure, style, and testing sections are conditional rather than a six-section completion form:
|
|
66
|
+
|
|
67
|
+
1. **Objective** — What are we building and why? Who is the user? What does success look like?
|
|
68
|
+
|
|
69
|
+
2. **Commands, when setup or verification is affected** — Use current project-documented commands with flags, not generic defaults.
|
|
70
|
+
```
|
|
71
|
+
Build: <project command, if applicable>
|
|
72
|
+
Test: <claim-matched command, if applicable>
|
|
73
|
+
Lint: <project command, if applicable>
|
|
74
|
+
Dev: <project command, if applicable>
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
3. **Project Structure, when placement changes** — Where affected source, tests, or docs belong.
|
|
78
|
+
```
|
|
79
|
+
src/ → Application source code
|
|
80
|
+
src/components → React components
|
|
81
|
+
src/lib → Shared utilities
|
|
82
|
+
tests/ → Unit and integration tests
|
|
83
|
+
e2e/ → End-to-end tests
|
|
84
|
+
docs/ → Documentation
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
4. **Code Style, when a new pattern is introduced** — Prefer one current repository example over generic prose.
|
|
88
|
+
|
|
89
|
+
5. **Testing Strategy, when acceptance needs it** — Name only the checks and placement needed by the affected behavior.
|
|
90
|
+
|
|
91
|
+
6. **Material boundaries** — Reference canonical rules for exact dependency, schema, auth/security, external, destructive, Git, and release gates instead of duplicating a generic checklist.
|
|
92
|
+
|
|
93
|
+
**Spec template:**
|
|
94
|
+
|
|
95
|
+
```markdown
|
|
96
|
+
# Spec: [Project/Feature Name]
|
|
97
|
+
|
|
98
|
+
## Objective
|
|
99
|
+
[What we're building and why. User stories or acceptance criteria.]
|
|
100
|
+
|
|
101
|
+
## Tech Stack
|
|
102
|
+
[Framework, language, key dependencies with versions]
|
|
103
|
+
|
|
104
|
+
## Commands
|
|
105
|
+
[Build, test, lint, dev — full commands]
|
|
106
|
+
|
|
107
|
+
## Project Structure
|
|
108
|
+
[Directory layout with descriptions]
|
|
109
|
+
|
|
110
|
+
## Code Style
|
|
111
|
+
[Example snippet + key conventions]
|
|
112
|
+
|
|
113
|
+
## Testing Strategy
|
|
114
|
+
[Framework, test locations, coverage requirements, test levels]
|
|
115
|
+
|
|
116
|
+
## Boundaries
|
|
117
|
+
- Always: [...]
|
|
118
|
+
- Ask first: [...]
|
|
119
|
+
- Never: [...]
|
|
120
|
+
|
|
121
|
+
## Success Criteria
|
|
122
|
+
[How we'll know this is done — specific, testable conditions]
|
|
123
|
+
|
|
124
|
+
## Open Questions
|
|
125
|
+
[Anything unresolved that needs human input]
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
**Reframe instructions as success criteria.** When receiving vague requirements, translate them into concrete conditions:
|
|
129
|
+
|
|
130
|
+
```
|
|
131
|
+
REQUIREMENT: "Make the dashboard faster"
|
|
132
|
+
|
|
133
|
+
REFRAMED SUCCESS CRITERIA:
|
|
134
|
+
- Dashboard LCP < 2.5s on 4G connection
|
|
135
|
+
- Initial data load completes in < 500ms
|
|
136
|
+
- No layout shift during load (CLS < 0.1)
|
|
137
|
+
→ Are these the right targets?
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
This lets you loop, retry, and problem-solve toward a clear goal rather than guessing what "faster" means.
|
|
141
|
+
|
|
142
|
+
### Spec Loophole Pass
|
|
143
|
+
|
|
144
|
+
After the first SPECIFY draft, run the following direct loophole checklist. Invoke no separate stress-test unless the user explicitly requested it or ROSE identified a concrete material loophole.
|
|
145
|
+
|
|
146
|
+
Check whether:
|
|
147
|
+
|
|
148
|
+
- success criteria are executable and measurable
|
|
149
|
+
- scope and non-goals are explicit
|
|
150
|
+
- Always / Ask First / Never boundaries cover high-risk areas
|
|
151
|
+
- user-facing terms are not overloaded
|
|
152
|
+
- architecture-sensitive assumptions are marked
|
|
153
|
+
- security, privacy, reliability, migration, compatibility, and rollback concerns are either covered or explicitly out of scope
|
|
154
|
+
- unresolved items are listed as `Open Question`
|
|
155
|
+
- unverifiable claims are marked `Unverified`
|
|
156
|
+
|
|
157
|
+
Do not proceed to PLAN until material loopholes are fixed, accepted by the user, or explicitly recorded as `Open Question` / `Unverified`.
|
|
158
|
+
|
|
159
|
+
🛑 **STOP before PLAN:** if any material loophole remains neither accepted nor recorded, return a clarification request instead of drafting a plan.
|
|
160
|
+
|
|
161
|
+
### Phase 2: Plan
|
|
162
|
+
|
|
163
|
+
With the validated spec, generate a technical implementation plan:
|
|
164
|
+
|
|
165
|
+
1. Identify the major components and their dependencies
|
|
166
|
+
2. Determine the implementation order (what must be built first)
|
|
167
|
+
3. Note risks and mitigation strategies
|
|
168
|
+
4. Identify what can be built in parallel vs. what must be sequential
|
|
169
|
+
5. Define verification checkpoints between phases
|
|
170
|
+
|
|
171
|
+
The plan should be reviewable: the human should be able to read it and say "yes, that's the right approach" or "no, change X."
|
|
172
|
+
|
|
173
|
+
🛑 **STOP before TASKS:** do not break work into tasks until the plan is coherent and material open risks are resolved or explicitly recorded under the AILI contract. This validation creates no extra approval gate.
|
|
174
|
+
|
|
175
|
+
### Phase 3: Tasks
|
|
176
|
+
|
|
177
|
+
Break the plan into discrete, implementable tasks:
|
|
178
|
+
|
|
179
|
+
- Each task should cover one coherent behavior or dependency boundary
|
|
180
|
+
- Each task has explicit acceptance criteria
|
|
181
|
+
- Each task names the smallest evidence needed for its affected claim, when any package-local evidence is needed
|
|
182
|
+
- Tasks are ordered by dependency, not by perceived importance
|
|
183
|
+
- Task boundaries follow behavior, dependencies, ownership, risk, and reversibility rather than a fixed file count
|
|
184
|
+
|
|
185
|
+
🛑 **STOP before IMPLEMENT:** do not start coding until tasks have acceptance criteria and any claim-matched evidence targets they need, canonical artifacts are coherent/validated, and final `test-plan.md` has explicit user acceptance under the AILI lifecycle.
|
|
186
|
+
|
|
187
|
+
**Task template:**
|
|
188
|
+
```markdown
|
|
189
|
+
- [ ] Task: [Description]
|
|
190
|
+
- Acceptance: [What must be true when done]
|
|
191
|
+
- Verify: [How to confirm — test command, build, manual check]
|
|
192
|
+
- Files: [Which files will be touched]
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
### Phase 4: Implementation Handoff
|
|
196
|
+
|
|
197
|
+
Return implementation readiness and the next dependency to ROSE. Implementation uses the canonical ordinary/BUILD owner; this skill does not invoke incremental, TDD, context, or other process skills.
|
|
198
|
+
|
|
199
|
+
## Keeping the Spec Alive
|
|
200
|
+
|
|
201
|
+
The spec is a living document, not a one-time artifact:
|
|
202
|
+
|
|
203
|
+
- **Update when decisions change** — If you discover the data model needs to change, update the spec first, then implement.
|
|
204
|
+
- **Update when scope changes** — Features added or cut should be reflected in the spec.
|
|
205
|
+
- **Version the spec when authorized** — The spec belongs in version control, but commit remains an exact Git operation approval.
|
|
206
|
+
- **Reference the spec in PRs** — Link back to the spec section that each PR implements.
|
|
207
|
+
|
|
208
|
+
## Common Rationalizations
|
|
209
|
+
|
|
210
|
+
| Rationalization | Reality |
|
|
211
|
+
|---|---|
|
|
212
|
+
| "This is simple, I don't need a spec" | Ordinary bounded work may remain ordinary; use this skill only when explicit spec intent or a material ambiguity selects it. |
|
|
213
|
+
| "I'll write the spec after I code it" | That's documentation, not specification. The spec's value is in forcing clarity *before* code. |
|
|
214
|
+
| "The spec will slow us down" | Once formal specification is selected, keep it dependency-ready and no larger than the decisions it must preserve. |
|
|
215
|
+
| "Requirements will change anyway" | That's why the spec is a living document. An outdated spec is still better than no spec. |
|
|
216
|
+
| "The user knows what they want" | Surface only assumptions that can materially change the selected formal contract; do not manufacture questions for settled ordinary work. |
|
|
217
|
+
|
|
218
|
+
## Red Flags
|
|
219
|
+
|
|
220
|
+
- Treating every implementation as formal specification work
|
|
221
|
+
- Proceeding inside a selected formal change while material acceptance remains unresolved
|
|
222
|
+
- Inferring acceptance from silence or an uncorrected assumption
|
|
223
|
+
- Implementing behavior outside the accepted formal scope
|
|
224
|
+
- Making a material architecture/public-contract decision without returning it to the lifecycle owner
|
|
225
|
+
|
|
226
|
+
## Verification
|
|
227
|
+
|
|
228
|
+
Before proceeding to implementation, confirm:
|
|
229
|
+
|
|
230
|
+
- [ ] The directly applicable behavior, acceptance, and material boundaries are specified
|
|
231
|
+
- [ ] Only dependency-ready canonical artifacts were written and reread
|
|
232
|
+
- [ ] Success criteria are specific and testable
|
|
233
|
+
- [ ] Open questions and `Unverified` items remain explicit
|
|
234
|
+
- [ ] The lifecycle owner selected any required structural validation
|
|
235
|
+
- [ ] For formal AILI work, the final `test-plan.md` has explicit user acceptance before implementation
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Addy Osmani
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Upstream reference notice
|
|
2
|
+
|
|
3
|
+
- Repository: `https://github.com/addyosmani/agent-skills`
|
|
4
|
+
- Commit: `6bcfeb9dae52b11eaad23511acc165109746dbc3`
|
|
5
|
+
- Copyright: Copyright (c) 2025 Addy Osmani
|
|
6
|
+
- License: root MIT `LICENSE` copied beside this notice
|
|
7
|
+
- Mapping: `skills/spec-driven-development/SKILL.md` → `spec-driven-development/SKILL.upstream.md`
|
|
8
|
+
|
|
9
|
+
The pinned closure is inert provenance/reference data, not a runnable skill, command, approval, integrity authority, or permission grant. Canonical behavior remains `.agents/skills/spec-driven-development/SKILL.md`.
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spec-driven-development
|
|
3
|
+
description: Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Spec-Driven Development
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Write a structured specification before writing any code. The spec is the shared source of truth between you and the human engineer — it defines what we're building, why, and how we'll know it's done. Code without a spec is guessing.
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
- Starting a new project or feature
|
|
15
|
+
- Requirements are ambiguous or incomplete
|
|
16
|
+
- The change touches multiple files or modules
|
|
17
|
+
- You're about to make an architectural decision
|
|
18
|
+
- The task would take more than 30 minutes to implement
|
|
19
|
+
|
|
20
|
+
**When NOT to use:** Single-line fixes, typo corrections, or changes where requirements are unambiguous and self-contained.
|
|
21
|
+
|
|
22
|
+
## The Gated Workflow
|
|
23
|
+
|
|
24
|
+
Spec-driven development has four phases. Do not advance to the next phase until the current one is validated.
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
SPECIFY ──→ PLAN ──→ TASKS ──→ IMPLEMENT
|
|
28
|
+
│ │ │ │
|
|
29
|
+
▼ ▼ ▼ ▼
|
|
30
|
+
Human Human Human Human
|
|
31
|
+
reviews reviews reviews reviews
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Phase 1: Specify
|
|
35
|
+
|
|
36
|
+
Start with a high-level vision. Ask the human clarifying questions until requirements are concrete.
|
|
37
|
+
|
|
38
|
+
**Surface assumptions immediately.** Before writing any spec content, list what you're assuming:
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
ASSUMPTIONS I'M MAKING:
|
|
42
|
+
1. This is a web application (not native mobile)
|
|
43
|
+
2. Authentication uses session-based cookies (not JWT)
|
|
44
|
+
3. The database is PostgreSQL (based on existing Prisma schema)
|
|
45
|
+
4. We're targeting modern browsers only (no IE11)
|
|
46
|
+
→ Correct me now or I'll proceed with these.
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Don't silently fill in ambiguous requirements. The spec's entire purpose is to surface misunderstandings *before* code gets written — assumptions are the most dangerous form of misunderstanding.
|
|
50
|
+
|
|
51
|
+
**Write a spec document covering these six core areas:**
|
|
52
|
+
|
|
53
|
+
1. **Objective** — What are we building and why? Who is the user? What does success look like?
|
|
54
|
+
|
|
55
|
+
2. **Commands** — Full executable commands with flags, not just tool names.
|
|
56
|
+
```
|
|
57
|
+
Build: npm run build
|
|
58
|
+
Test: npm test -- --coverage
|
|
59
|
+
Lint: npm run lint --fix
|
|
60
|
+
Dev: npm run dev
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
3. **Project Structure** — Where source code lives, where tests go, where docs belong.
|
|
64
|
+
```
|
|
65
|
+
src/ → Application source code
|
|
66
|
+
src/components → React components
|
|
67
|
+
src/lib → Shared utilities
|
|
68
|
+
tests/ → Unit and integration tests
|
|
69
|
+
e2e/ → End-to-end tests
|
|
70
|
+
docs/ → Documentation
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
4. **Code Style** — One real code snippet showing your style beats three paragraphs describing it. Include naming conventions, formatting rules, and examples of good output.
|
|
74
|
+
|
|
75
|
+
5. **Testing Strategy** — What framework, where tests live, coverage expectations, which test levels for which concerns.
|
|
76
|
+
|
|
77
|
+
6. **Boundaries** — Three-tier system:
|
|
78
|
+
- **Always do:** Run tests before commits, follow naming conventions, validate inputs
|
|
79
|
+
- **Ask first:** Database schema changes, adding dependencies, changing CI config
|
|
80
|
+
- **Never do:** Commit secrets, edit vendor directories, remove failing tests without approval
|
|
81
|
+
|
|
82
|
+
**Spec template:**
|
|
83
|
+
|
|
84
|
+
```markdown
|
|
85
|
+
# Spec: [Project/Feature Name]
|
|
86
|
+
|
|
87
|
+
## Objective
|
|
88
|
+
[What we're building and why. User stories or acceptance criteria.]
|
|
89
|
+
|
|
90
|
+
## Tech Stack
|
|
91
|
+
[Framework, language, key dependencies with versions]
|
|
92
|
+
|
|
93
|
+
## Commands
|
|
94
|
+
[Build, test, lint, dev — full commands]
|
|
95
|
+
|
|
96
|
+
## Project Structure
|
|
97
|
+
[Directory layout with descriptions]
|
|
98
|
+
|
|
99
|
+
## Code Style
|
|
100
|
+
[Example snippet + key conventions]
|
|
101
|
+
|
|
102
|
+
## Testing Strategy
|
|
103
|
+
[Framework, test locations, coverage requirements, test levels]
|
|
104
|
+
|
|
105
|
+
## Boundaries
|
|
106
|
+
- Always: [...]
|
|
107
|
+
- Ask first: [...]
|
|
108
|
+
- Never: [...]
|
|
109
|
+
|
|
110
|
+
## Success Criteria
|
|
111
|
+
[How we'll know this is done — specific, testable conditions]
|
|
112
|
+
|
|
113
|
+
## Open Questions
|
|
114
|
+
[Anything unresolved that needs human input]
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
**Reframe instructions as success criteria.** When receiving vague requirements, translate them into concrete conditions:
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
REQUIREMENT: "Make the dashboard faster"
|
|
121
|
+
|
|
122
|
+
REFRAMED SUCCESS CRITERIA:
|
|
123
|
+
- Dashboard LCP < 2.5s on 4G connection
|
|
124
|
+
- Initial data load completes in < 500ms
|
|
125
|
+
- No layout shift during load (CLS < 0.1)
|
|
126
|
+
→ Are these the right targets?
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
This lets you loop, retry, and problem-solve toward a clear goal rather than guessing what "faster" means.
|
|
130
|
+
|
|
131
|
+
### Phase 2: Plan
|
|
132
|
+
|
|
133
|
+
With the validated spec, generate a technical implementation plan:
|
|
134
|
+
|
|
135
|
+
1. Identify the major components and their dependencies
|
|
136
|
+
2. Determine the implementation order (what must be built first)
|
|
137
|
+
3. Note risks and mitigation strategies
|
|
138
|
+
4. Identify what can be built in parallel vs. what must be sequential
|
|
139
|
+
5. Define verification checkpoints between phases
|
|
140
|
+
|
|
141
|
+
> Follow `planning-and-task-breakdown` for the dependency-graph mapping and vertical-slicing mechanics behind these steps; it is the canonical source. The bullets above are a lightweight summary; if they ever diverge, `planning-and-task-breakdown` takes precedence.
|
|
142
|
+
>
|
|
143
|
+
> **Output convention:** Save the plan to `tasks/plan.md` and the task list to `tasks/todo.md`, per the `/plan` command convention. Create `tasks/` if it does not exist. Downstream commands (`/build`, etc.) expect these paths.
|
|
144
|
+
|
|
145
|
+
The plan should be reviewable: the human should be able to read it and say "yes, that's the right approach" or "no, change X."
|
|
146
|
+
|
|
147
|
+
### Phase 3: Tasks
|
|
148
|
+
|
|
149
|
+
Break the plan into discrete, implementable tasks:
|
|
150
|
+
|
|
151
|
+
- Each task should be completable in a single focused session
|
|
152
|
+
- Each task has explicit acceptance criteria
|
|
153
|
+
- Each task includes a verification step (test, build, manual check)
|
|
154
|
+
- Tasks are ordered by dependency, not by perceived importance
|
|
155
|
+
- No task should require changing more than ~5 files
|
|
156
|
+
|
|
157
|
+
> Follow `planning-and-task-breakdown` for the full task-sizing and dependency-ordering mechanics; it is the canonical source. The template below is a lightweight inline form; if they ever diverge, `planning-and-task-breakdown` takes precedence.
|
|
158
|
+
|
|
159
|
+
**Task template:**
|
|
160
|
+
```markdown
|
|
161
|
+
- [ ] Task: [Description]
|
|
162
|
+
- Acceptance: [What must be true when done]
|
|
163
|
+
- Verify: [How to confirm — test command, build, manual check]
|
|
164
|
+
- Files: [Which files will be touched]
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
### Phase 4: Implement
|
|
168
|
+
|
|
169
|
+
Execute tasks one at a time following `skills/incremental-implementation/SKILL.md` (`incremental-implementation`) and `skills/test-driven-development/SKILL.md` (`test-driven-development`). Use `skills/context-engineering/SKILL.md` (`context-engineering`) to load the right spec sections and source files at each step rather than flooding the agent with the entire spec.
|
|
170
|
+
|
|
171
|
+
## Keeping the Spec Alive
|
|
172
|
+
|
|
173
|
+
The spec is a living document, not a one-time artifact:
|
|
174
|
+
|
|
175
|
+
- **Update when decisions change** — If you discover the data model needs to change, update the spec first, then implement.
|
|
176
|
+
- **Update when scope changes** — Features added or cut should be reflected in the spec.
|
|
177
|
+
- **Commit the spec** — The spec belongs in version control alongside the code.
|
|
178
|
+
- **Reference the spec in PRs** — Link back to the spec section that each PR implements.
|
|
179
|
+
|
|
180
|
+
## Common Rationalizations
|
|
181
|
+
|
|
182
|
+
| Rationalization | Reality |
|
|
183
|
+
|---|---|
|
|
184
|
+
| "This is simple, I don't need a spec" | Simple tasks don't need *long* specs, but they still need acceptance criteria. A two-line spec is fine. |
|
|
185
|
+
| "I'll write the spec after I code it" | That's documentation, not specification. The spec's value is in forcing clarity *before* code. |
|
|
186
|
+
| "The spec will slow us down" | A 15-minute spec prevents hours of rework. Waterfall in 15 minutes beats debugging in 15 hours. |
|
|
187
|
+
| "Requirements will change anyway" | That's why the spec is a living document. An outdated spec is still better than no spec. |
|
|
188
|
+
| "The user knows what they want" | Even clear requests have implicit assumptions. The spec surfaces those assumptions. |
|
|
189
|
+
|
|
190
|
+
## Red Flags
|
|
191
|
+
|
|
192
|
+
- Starting to write code without any written requirements
|
|
193
|
+
- Asking "should I just start building?" before clarifying what "done" means
|
|
194
|
+
- Implementing features not mentioned in any spec or task list
|
|
195
|
+
- Making architectural decisions without documenting them
|
|
196
|
+
- Skipping the spec because "it's obvious what to build"
|
|
197
|
+
|
|
198
|
+
## Verification
|
|
199
|
+
|
|
200
|
+
Before proceeding to implementation, confirm:
|
|
201
|
+
|
|
202
|
+
- [ ] The spec covers all six core areas
|
|
203
|
+
- [ ] The human has reviewed and approved the spec
|
|
204
|
+
- [ ] Success criteria are specific and testable
|
|
205
|
+
- [ ] Boundaries (Always/Ask First/Never) are defined
|
|
206
|
+
- [ ] The spec is saved to a file in the repository
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: strategy-stress-test
|
|
3
|
+
description: Run one bounded adversarial pass when the user explicitly requests a report-style stress test or ROSE identifies a concrete material loophole in an existing strategy, spec, plan, review, or claim; do not trigger for an interactive grill/frontier interview or merely before write-back, implementation, reconciliation, or completion.
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
source: local-workflow-guardrail
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Strategy Stress Test
|
|
10
|
+
|
|
11
|
+
## Purpose
|
|
12
|
+
|
|
13
|
+
Use this skill to turn "are we confident enough?" into an engineering guardrail.
|
|
14
|
+
|
|
15
|
+
Do not pursue artificial 100% certainty. Target factually supportable high confidence.
|
|
16
|
+
|
|
17
|
+
If the user asks for 100% confidence, treat that as a request to stress-test harder, not as permission to manufacture certainty. Stop when the claim is supported, conditional, or explicitly marked with `Open Question` / `Unverified` items.
|
|
18
|
+
|
|
19
|
+
If confidence is not supportable, identify material loopholes, missing evidence, counterexamples, hidden assumptions, verification gaps, and repair options.
|
|
20
|
+
|
|
21
|
+
Anything still unresolved must be marked as `Open Question` or `Unverified`.
|
|
22
|
+
|
|
23
|
+
## When to Use
|
|
24
|
+
|
|
25
|
+
Use this skill only when a concrete draft or claim exists and either the user explicitly asks to challenge/stress-test it or ROSE names one material loophole that direct inspection cannot safely close inline.
|
|
26
|
+
|
|
27
|
+
Routing boundary: a request to inspect an artifact and report loopholes without interviewing the user belongs here. A request to grill/interview the user's decisions, including an explicitly requested frontier batch, belongs to the single canonical `requirements-grilling` capability. Do not register or invoke a second `batch-grill-me` skill.
|
|
28
|
+
|
|
29
|
+
Positive triggers:
|
|
30
|
+
|
|
31
|
+
- "Stress-test this design before I accept it."
|
|
32
|
+
- "Challenge this plan for rollback gaps."
|
|
33
|
+
- A named contradiction, missing failure path, or unsupported completion claim that can change a material decision.
|
|
34
|
+
|
|
35
|
+
Near misses: an interactive “grill me”, “interview me”, “batch grill me”, or equivalent decision-elicitation request; an artifact merely exists; a file is about to be written; implementation/review is ending; confidence is requested without a named loophole; or ordinary verification is pending. Interactive decision elicitation routes to `requirements-grilling`; in the other cases the active owner works directly.
|
|
36
|
+
|
|
37
|
+
ROSE/`aili-delivery-flow` owns lifecycle state, approvals, writeback, and verification. This skill does not invoke research, requirements, test-plan, review, security, or another process skill. It returns one concrete need or material delta to ROSE and stops. Canonical approval and verification rules win any conflict.
|
|
38
|
+
|
|
39
|
+
## Loop Limit
|
|
40
|
+
|
|
41
|
+
Run exactly one bounded challenge pass per trigger.
|
|
42
|
+
|
|
43
|
+
Stop earlier when:
|
|
44
|
+
|
|
45
|
+
- all material loopholes are resolved
|
|
46
|
+
- remaining issues are explicitly marked `Open Question` or `Unverified`
|
|
47
|
+
- further work would only produce wording tweaks, low-risk nitpicks, or speculative concerns
|
|
48
|
+
|
|
49
|
+
If a material issue remains, return it to ROSE; do not start a second pass or another process skill automatically.
|
|
50
|
+
|
|
51
|
+
## Process
|
|
52
|
+
|
|
53
|
+
For each loop:
|
|
54
|
+
|
|
55
|
+
1. Restate the current strategy, spec, plan, review, interview packet, or completion claim in one short paragraph.
|
|
56
|
+
2. Ask whether it is factually supported enough to proceed.
|
|
57
|
+
3. If not, list only material loopholes that could change scope, design, task order, acceptance criteria, verification, security, privacy, reliability, rollout, or user decisions.
|
|
58
|
+
4. Classify each loophole as one of: Missing evidence, Hidden assumption, Counterexample, Edge case, Contradiction, Dependency/order problem, Security/privacy/reliability risk, Verification gap, or User decision required.
|
|
59
|
+
5. For each loophole, choose one repair action: edit the current artifact, inspect targeted repository evidence, return an exact source need to ROSE, ask through the canonical owner, defer as `Open Question`, or mark as `Unverified`.
|
|
60
|
+
6. Apply fixes only when they are within scope, allowed by the current mode, and supported by evidence.
|
|
61
|
+
7. Return remaining material loopholes to ROSE and stop.
|
|
62
|
+
|
|
63
|
+
## Adversarial Lenses
|
|
64
|
+
|
|
65
|
+
When the artifact is non-trivial, stress-test it through these lenses without turning the output into a long debate:
|
|
66
|
+
|
|
67
|
+
1. Pragmatist Skeptic
|
|
68
|
+
- What can be deleted?
|
|
69
|
+
- Is this over-engineered?
|
|
70
|
+
- Is this abstraction premature?
|
|
71
|
+
2. Integration Validator
|
|
72
|
+
- What adjacent module, state transition, failure path, or regression is missing?
|
|
73
|
+
- What test proves this?
|
|
74
|
+
3. Evidence Researcher
|
|
75
|
+
- Which claims are unsupported?
|
|
76
|
+
- Which claims need repository evidence, official docs, or user confirmation?
|
|
77
|
+
4. Architect
|
|
78
|
+
- Does this violate boundaries?
|
|
79
|
+
- Does it introduce coupling or future maintenance debt?
|
|
80
|
+
5. Creative Challenger
|
|
81
|
+
- Is there a simpler, more direct, or less invasive path?
|
|
82
|
+
- Is there a better artifact shape?
|
|
83
|
+
|
|
84
|
+
Keep only material findings in the final stress-test result.
|
|
85
|
+
|
|
86
|
+
If the needed tool or skill is unavailable:
|
|
87
|
+
|
|
88
|
+
- perform the compact check inline when possible
|
|
89
|
+
- mark only the affected claim as `Unverified`
|
|
90
|
+
- mention tool unavailability only when it changes the result or blocks verification
|
|
91
|
+
|
|
92
|
+
## Evidence Rules
|
|
93
|
+
|
|
94
|
+
Use evidence before confidence.
|
|
95
|
+
|
|
96
|
+
Carry the global Evidence-Driven Claim Hygiene rule into the stress test: tag every claim in stress-test conclusions, use `CONFIDENCE: HIGH | MED | LOW | VERY LOW | UNKNOWN` for internal reports, localize user-facing tags/confidence labels when available, and treat anti-sycophancy red flags such as an unusually elegant explanation, one pattern explaining everything, agreement after pushback without evidence, or specifics for unearned authority as reasons to cut specifics, add `[GUESS]`, or say `I don't know.`
|
|
97
|
+
|
|
98
|
+
Valid evidence can include:
|
|
99
|
+
|
|
100
|
+
- user-confirmed answers
|
|
101
|
+
- current spec, design, tasks, or acceptance docs
|
|
102
|
+
- repository source files, tests, schemas, configs, logs, or diffs
|
|
103
|
+
- official documentation or current web sources when external behavior matters
|
|
104
|
+
- fresh verification command output
|
|
105
|
+
- reconciled subagent evidence with anchors
|
|
106
|
+
|
|
107
|
+
Invalid evidence:
|
|
108
|
+
|
|
109
|
+
- intuition
|
|
110
|
+
- stale logs
|
|
111
|
+
- partial output not read fully
|
|
112
|
+
- unverified assumptions
|
|
113
|
+
- `should work` language
|
|
114
|
+
- subagent conclusions without evidence anchors
|
|
115
|
+
|
|
116
|
+
## 🛑 Anti-Pattern Blacklist
|
|
117
|
+
|
|
118
|
+
Stop and repair the stress test if it does any of these:
|
|
119
|
+
|
|
120
|
+
- Manufactures certainty to satisfy a requested confidence level.
|
|
121
|
+
- Replaces missing evidence with confident tone, generic best practice, or “likely”.
|
|
122
|
+
- Treats a passing narrow check as proof of broad readiness.
|
|
123
|
+
- Hides unresolved user decisions inside assumptions.
|
|
124
|
+
- Ignores counter-evidence because it complicates the plan or final claim.
|
|
125
|
+
- Runs more loops only to polish wording instead of resolving material loopholes.
|
|
126
|
+
- Reports subagent conclusions without anchors or conflict reconciliation.
|
|
127
|
+
|
|
128
|
+
Fallback: downgrade confidence, mark the affected item `Open Question` or `Unverified`, and choose a concrete repair action from the process table.
|
|
129
|
+
|
|
130
|
+
## Output Contract
|
|
131
|
+
|
|
132
|
+
Return this structure when reporting the stress-test result:
|
|
133
|
+
|
|
134
|
+
```text
|
|
135
|
+
CONFIDENCE: HIGH | MED | LOW | VERY LOW | UNKNOWN
|
|
136
|
+
|
|
137
|
+
Current artifact / claim:
|
|
138
|
+
- ...
|
|
139
|
+
|
|
140
|
+
Material loopholes found:
|
|
141
|
+
- [Category] Loophole:
|
|
142
|
+
Evidence gap:
|
|
143
|
+
Proposed fix:
|
|
144
|
+
Status: fixed | ask_user | inspect_code | fetch_docs | open_question | unverified
|
|
145
|
+
|
|
146
|
+
Fixes applied:
|
|
147
|
+
- ...
|
|
148
|
+
|
|
149
|
+
Remaining open questions:
|
|
150
|
+
- Open Question: ...
|
|
151
|
+
|
|
152
|
+
Remaining unverified items:
|
|
153
|
+
- Unverified: ...
|
|
154
|
+
|
|
155
|
+
Evidence used:
|
|
156
|
+
- ...
|
|
157
|
+
|
|
158
|
+
Safe to proceed: yes | no | conditional
|
|
159
|
+
Reason:
|
|
160
|
+
- ...
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
## Integration Rules
|
|
164
|
+
|
|
165
|
+
When ROSE selects this as the one bounded auxiliary pass for a primary artifact owner:
|
|
166
|
+
|
|
167
|
+
- Do not replace the caller skill.
|
|
168
|
+
- Do not invoke another skill or continue into another lifecycle loop.
|
|
169
|
+
- Do not write files unless the caller skill and current mode allow edits.
|
|
170
|
+
- Keep the output compact enough to paste into a final report or artifact appendix.
|
|
171
|
+
- Prefer editing the artifact to adding a long critique when the fix is obvious and allowed.
|
|
172
|
+
|
|
173
|
+
## Example: Compact Embedded Use
|
|
174
|
+
|
|
175
|
+
Input artifact:
|
|
176
|
+
|
|
177
|
+
- Plan says: "Implement auth callback handling and update tests."
|
|
178
|
+
|
|
179
|
+
Stress-test result:
|
|
180
|
+
|
|
181
|
+
- CONFIDENCE: MED
|
|
182
|
+
- Material loophole: Verification gap - plan does not name the callback error cases or tests.
|
|
183
|
+
- Fix applied: add tasks for invalid state, expired code, provider error, and existing callback test file inspection.
|
|
184
|
+
- Remaining unverified: exact test command until package scripts are inspected.
|
|
185
|
+
- Safe to proceed: conditional.
|