gabbe-kit 1.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/LICENSE +25 -0
- package/LICENSE-CODE +202 -0
- package/README.md +817 -0
- package/agents/AGENTS.md +542 -0
- package/agents/CONSTITUTION.md +188 -0
- package/agents/guides/00-index.md +142 -0
- package/agents/guides/ai/a2ui-protocols.md +71 -0
- package/agents/guides/ai/actor-agent-frameworks.md +82 -0
- package/agents/guides/ai/agent-communication.md +146 -0
- package/agents/guides/ai/agent-identity-trust.md +69 -0
- package/agents/guides/ai/agent-only-cognition.md +73 -0
- package/agents/guides/ai/agent-only-swarms.md +70 -0
- package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
- package/agents/guides/ai/agent-ui.md +106 -0
- package/agents/guides/ai/ai-agentic.md +309 -0
- package/agents/guides/ai/beyond-llms.md +60 -0
- package/agents/guides/ai/dynamic-capability-loading.md +121 -0
- package/agents/guides/ai/gabbe-innovations.md +111 -0
- package/agents/guides/ai/model-customization-decisions.md +78 -0
- package/agents/guides/ai/multi-agent-systems.md +85 -0
- package/agents/guides/ai/self-evolving-skills.md +137 -0
- package/agents/guides/ai/self-healing-summary.md +21 -0
- package/agents/guides/ai/visual-mcp-integration.md +106 -0
- package/agents/guides/architecture/api-standards.md +61 -0
- package/agents/guides/architecture/blockchain-dlt.md +36 -0
- package/agents/guides/architecture/critical-systems-arch.md +66 -0
- package/agents/guides/architecture/event-driven-architecture.md +39 -0
- package/agents/guides/architecture/microservices.md +292 -0
- package/agents/guides/architecture/monolith.md +303 -0
- package/agents/guides/architecture/orchestration.md +75 -0
- package/agents/guides/architecture/system-qualities.md +51 -0
- package/agents/guides/architecture/system-scalability.md +47 -0
- package/agents/guides/architecture/systems-architecture.md +506 -0
- package/agents/guides/data/semantic-web.md +23 -0
- package/agents/guides/data/sql-nosql.md +305 -0
- package/agents/guides/industry/engineering-standards.md +36 -0
- package/agents/guides/industry/global-standards.md +24 -0
- package/agents/guides/industry/healthcare-fhir.md +33 -0
- package/agents/guides/industry/industrial-iot.md +33 -0
- package/agents/guides/industry/telecom-networks.md +34 -0
- package/agents/guides/languages/c-sharp.md +66 -0
- package/agents/guides/languages/go-lang.md +251 -0
- package/agents/guides/languages/java.md +73 -0
- package/agents/guides/languages/js-ts-nodejs.md +361 -0
- package/agents/guides/languages/nodejs-advanced.md +56 -0
- package/agents/guides/languages/php-laravel.md +376 -0
- package/agents/guides/languages/python-fastapi-ai.md +257 -0
- package/agents/guides/languages/rust.md +73 -0
- package/agents/guides/ops/compliance-audit.md +177 -0
- package/agents/guides/ops/cost-optimization.md +57 -0
- package/agents/guides/ops/dev-environments.md +67 -0
- package/agents/guides/ops/dev-workflow.md +44 -0
- package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
- package/agents/guides/ops/production-health.md +62 -0
- package/agents/guides/ops/troubleshooting-guide.md +69 -0
- package/agents/guides/patterns/agentic-design-patterns.md +308 -0
- package/agents/guides/patterns/agentic-patterns.md +43 -0
- package/agents/guides/patterns/ai-native-scenarios.md +71 -0
- package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
- package/agents/guides/patterns/design-patterns.md +68 -0
- package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
- package/agents/guides/patterns/enterprise-patterns.md +56 -0
- package/agents/guides/patterns/software-design-patterns.md +106 -0
- package/agents/guides/patterns/time-complexity-analysis.md +116 -0
- package/agents/guides/planning/product-requirements.md +407 -0
- package/agents/guides/planning/strategic-analysis.md +98 -0
- package/agents/guides/planning/visual-product-specs.md +162 -0
- package/agents/guides/principles/clean-code-standards.md +51 -0
- package/agents/guides/principles/computing-foundations.md +87 -0
- package/agents/guides/principles/diagramming-standards.md +568 -0
- package/agents/guides/principles/evaluation-strategy.md +103 -0
- package/agents/guides/principles/future-tech.md +35 -0
- package/agents/guides/principles/human-agent-collaboration.md +54 -0
- package/agents/guides/principles/legacy-tech.md +61 -0
- package/agents/guides/principles/mathematical-foundations.md +103 -0
- package/agents/guides/principles/modeling-methods.md +97 -0
- package/agents/guides/principles/no-code-integration.md +84 -0
- package/agents/guides/principles/testing-strategy.md +97 -0
- package/agents/guides/principles/visual-design-system.md +44 -0
- package/agents/guides/processes/RARV_CYCLE.md +262 -0
- package/agents/guides/processes/extension-protocol.md +183 -0
- package/agents/guides/processes/full-system-lifecycle.md +47 -0
- package/agents/guides/processes/knowledge-integration.md +82 -0
- package/agents/guides/processes/loki-sdlc-phases.md +446 -0
- package/agents/guides/product/green-software.md +38 -0
- package/agents/guides/product/sustainability-checks.md +29 -0
- package/agents/guides/security/ai-risk-standards-map.md +98 -0
- package/agents/guides/security/api-security.md +51 -0
- package/agents/guides/security/cryptography-standards.md +38 -0
- package/agents/guides/security/privacy-data-protection.md +41 -0
- package/agents/guides/security/secure-architecture.md +43 -0
- package/agents/guides/security/threat-modeling.md +46 -0
- package/agents/memory/AUDIT_LOG.md +48 -0
- package/agents/memory/CONTINUITY.md +49 -0
- package/agents/memory/PROJECT_STATE.md +134 -0
- package/agents/memory/RESUME_POINTER.md +15 -0
- package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
- package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
- package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
- package/agents/personas/00-index.md +148 -0
- package/agents/personas/biz-compliance.md +112 -0
- package/agents/personas/biz-legal.md +131 -0
- package/agents/personas/eng-api.md +110 -0
- package/agents/personas/eng-backend.md +113 -0
- package/agents/personas/eng-data.md +50 -0
- package/agents/personas/eng-database.md +95 -0
- package/agents/personas/eng-frontend.md +75 -0
- package/agents/personas/eng-infra.md +105 -0
- package/agents/personas/eng-messaging.md +50 -0
- package/agents/personas/eng-ml.md +50 -0
- package/agents/personas/eng-mobile.md +75 -0
- package/agents/personas/eng-perf.md +90 -0
- package/agents/personas/eng-qa.md +125 -0
- package/agents/personas/eng-tooling.md +49 -0
- package/agents/personas/ops-compliance.md +109 -0
- package/agents/personas/ops-cost.md +92 -0
- package/agents/personas/ops-devops.md +85 -0
- package/agents/personas/ops-incident.md +123 -0
- package/agents/personas/ops-monitor.md +89 -0
- package/agents/personas/ops-release.md +91 -0
- package/agents/personas/ops-security.md +104 -0
- package/agents/personas/ops-sre.md +85 -0
- package/agents/personas/orch-coordinator.md +140 -0
- package/agents/personas/orch-judge.md +135 -0
- package/agents/personas/orch-planner.md +114 -0
- package/agents/personas/orch-researcher.md +165 -0
- package/agents/personas/prod-architect.md +110 -0
- package/agents/personas/prod-design.md +112 -0
- package/agents/personas/prod-ethicist.md +50 -0
- package/agents/personas/prod-integration.md +120 -0
- package/agents/personas/prod-pm.md +115 -0
- package/agents/personas/prod-product-ops.md +128 -0
- package/agents/personas/prod-research.md +49 -0
- package/agents/personas/prod-safety-engineer.md +28 -0
- package/agents/personas/prod-tech-lead.md +119 -0
- package/agents/personas/ui-design.md +81 -0
- package/agents/scripts/check_skills_docs.py +120 -0
- package/agents/scripts/compile_skills.py +284 -0
- package/agents/scripts/comprehensive_checker.py +187 -0
- package/agents/scripts/dump-context.sh +37 -0
- package/agents/scripts/eval_skills.py +268 -0
- package/agents/scripts/preflight_summary.sh +80 -0
- package/agents/scripts/report_duplicates.py +125 -0
- package/agents/scripts/setup-context.ps1 +250 -0
- package/agents/scripts/setup-context.sh +398 -0
- package/agents/scripts/state_export.sh +84 -0
- package/agents/scripts/state_import.sh +99 -0
- package/agents/scripts/validate_integrity.py +98 -0
- package/agents/scripts/validate_links.py +96 -0
- package/agents/scripts/validate_methodology_graph.py +194 -0
- package/agents/scripts/validate_skills.py +81 -0
- package/agents/scripts/verify_e2e_init_flows.py +246 -0
- package/agents/scripts/verify_setup_simulation.py +104 -0
- package/agents/scripts/verify_triggers_and_mcps.py +159 -0
- package/agents/scripts/verify_use_cases.py +498 -0
- package/agents/skills/00-index.md +322 -0
- package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
- package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
- package/agents/skills/ai/agent-communication.skill.md +36 -0
- package/agents/skills/ai/agent-ui.skill.md +31 -0
- package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
- package/agents/skills/ai/beyond-llms.skill.md +31 -0
- package/agents/skills/ai/context-engineering.skill.md +79 -0
- package/agents/skills/ai/llm-as-judge.skill.md +97 -0
- package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
- package/agents/skills/ai/rag-evaluation.skill.md +93 -0
- package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
- package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
- package/agents/skills/architecture/api-design.skill.md +92 -0
- package/agents/skills/architecture/api-standards.skill.md +31 -0
- package/agents/skills/architecture/arch-debt.skill.md +180 -0
- package/agents/skills/architecture/arch-design.skill.md +304 -0
- package/agents/skills/architecture/arch-patterns.skill.md +52 -0
- package/agents/skills/architecture/arch-review.skill.md +326 -0
- package/agents/skills/architecture/architecture-governance.skill.md +62 -0
- package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
- package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
- package/agents/skills/architecture/compatibility-design.skill.md +51 -0
- package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
- package/agents/skills/architecture/design-patterns.skill.md +59 -0
- package/agents/skills/architecture/diagramming.skill.md +380 -0
- package/agents/skills/architecture/domain-model.skill.md +294 -0
- package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
- package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
- package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
- package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
- package/agents/skills/architecture/event-governance.skill.md +55 -0
- package/agents/skills/architecture/fitness-functions.skill.md +111 -0
- package/agents/skills/architecture/graphql-schema.skill.md +64 -0
- package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
- package/agents/skills/architecture/microservices.skill.md +31 -0
- package/agents/skills/architecture/middleware-design.skill.md +59 -0
- package/agents/skills/architecture/monolith.skill.md +31 -0
- package/agents/skills/architecture/realtime-comm.skill.md +52 -0
- package/agents/skills/architecture/state-management.skill.md +72 -0
- package/agents/skills/architecture/system-qualities.skill.md +31 -0
- package/agents/skills/architecture/system-scalability.skill.md +31 -0
- package/agents/skills/architecture/systems-architecture.skill.md +31 -0
- package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
- package/agents/skills/brain/README.md +70 -0
- package/agents/skills/brain/active-inference.skill.md +74 -0
- package/agents/skills/brain/brain-mode.skill.md +125 -0
- package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
- package/agents/skills/brain/cognitive-testing.skill.md +62 -0
- package/agents/skills/brain/consciousness-loop.skill.md +68 -0
- package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
- package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
- package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
- package/agents/skills/brain/global-workspace.skill.md +77 -0
- package/agents/skills/brain/learning-adaptation.skill.md +68 -0
- package/agents/skills/brain/loki-mode.skill.md +267 -0
- package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
- package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
- package/agents/skills/brain/scripts/cognition_test.py +80 -0
- package/agents/skills/brain/scripts/global_workspace.py +104 -0
- package/agents/skills/brain/self-improvement.skill.md +80 -0
- package/agents/skills/brain/sensory-motor.skill.md +61 -0
- package/agents/skills/brain/sequential-thinking.skill.md +48 -0
- package/agents/skills/brain/working-memory.skill.md +47 -0
- package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
- package/agents/skills/coding/artisan-commands.skill.md +52 -0
- package/agents/skills/coding/browser-tdd.skill.md +131 -0
- package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
- package/agents/skills/coding/ci-autofix.skill.md +53 -0
- package/agents/skills/coding/clean-coder.skill.md +58 -0
- package/agents/skills/coding/code-review.skill.md +100 -0
- package/agents/skills/coding/debug.skill.md +100 -0
- package/agents/skills/coding/documentation.skill.md +149 -0
- package/agents/skills/coding/eval-driven-development.skill.md +107 -0
- package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
- package/agents/skills/coding/excalidraw.skill.md +90 -0
- package/agents/skills/coding/file-processing.skill.md +55 -0
- package/agents/skills/coding/git-workflow.skill.md +153 -0
- package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
- package/agents/skills/coding/mobile-dev.skill.md +41 -0
- package/agents/skills/coding/nodejs-expert.skill.md +23 -0
- package/agents/skills/coding/output-validation.skill.md +57 -0
- package/agents/skills/coding/pbt-strategy.skill.md +117 -0
- package/agents/skills/coding/performant-ai.skill.md +62 -0
- package/agents/skills/coding/performant-go.skill.md +61 -0
- package/agents/skills/coding/performant-laravel.skill.md +70 -0
- package/agents/skills/coding/performant-nodejs.skill.md +67 -0
- package/agents/skills/coding/performant-php.skill.md +53 -0
- package/agents/skills/coding/performant-python.skill.md +62 -0
- package/agents/skills/coding/refactor.skill.md +124 -0
- package/agents/skills/coding/secure-coding.skill.md +57 -0
- package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
- package/agents/skills/coding/spec-driven-development.skill.md +110 -0
- package/agents/skills/coding/tdd-cycle.skill.md +92 -0
- package/agents/skills/coding/testing-strategy.skill.md +74 -0
- package/agents/skills/coding/time-complexity.skill.md +112 -0
- package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
- package/agents/skills/coding/tool-construction.skill.md +47 -0
- package/agents/skills/coding/ui-gen.skill.md +64 -0
- package/agents/skills/coding/vibe-coding.skill.md +63 -0
- package/agents/skills/coding/visual-design.skill.md +65 -0
- package/agents/skills/coordination/agent-interop.skill.md +72 -0
- package/agents/skills/coordination/agent-protocol.skill.md +62 -0
- package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
- package/agents/skills/coordination/agentic-linter.skill.md +134 -0
- package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
- package/agents/skills/coordination/meta-optimize.skill.md +62 -0
- package/agents/skills/coordination/meta-prompting.skill.md +46 -0
- package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
- package/agents/skills/coordination/persona-selector.skill.md +78 -0
- package/agents/skills/coordination/self-optimize.skill.md +81 -0
- package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
- package/agents/skills/core/agent-analytics.skill.md +74 -0
- package/agents/skills/core/audit-trail.skill.md +122 -0
- package/agents/skills/core/clarify.skill.md +89 -0
- package/agents/skills/core/emerging-tech.skill.md +52 -0
- package/agents/skills/core/empirical-methods.skill.md +101 -0
- package/agents/skills/core/evals/clarify.eval.yaml +29 -0
- package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
- package/agents/skills/core/evals/research.eval.yaml +23 -0
- package/agents/skills/core/final-review.skill.md +66 -0
- package/agents/skills/core/integrity-check.skill.md +149 -0
- package/agents/skills/core/knowledge-connect.skill.md +77 -0
- package/agents/skills/core/knowledge-gap.skill.md +123 -0
- package/agents/skills/core/preflight.skill.md +106 -0
- package/agents/skills/core/research.skill.md +107 -0
- package/agents/skills/core/retrospective.skill.md +59 -0
- package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
- package/agents/skills/core/self-heal.skill.md +163 -0
- package/agents/skills/core/session-resume.skill.md +125 -0
- package/agents/skills/core/skills-registry.skill.md +65 -0
- package/agents/skills/core/state-portability.skill.md +89 -0
- package/agents/skills/core/state-preserve.skill.md +76 -0
- package/agents/skills/core/system-lifecycle.skill.md +51 -0
- package/agents/skills/core/update-scan.skill.md +92 -0
- package/agents/skills/data/data-engineering.skill.md +56 -0
- package/agents/skills/data/data-governance.skill.md +49 -0
- package/agents/skills/data/db-migration.skill.md +136 -0
- package/agents/skills/data/semantic-web.skill.md +28 -0
- package/agents/skills/data/sql-optimization.skill.md +78 -0
- package/agents/skills/industry/engineering-standards.skill.md +31 -0
- package/agents/skills/industry/global-standards.skill.md +30 -0
- package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
- package/agents/skills/industry/industrial-iot.skill.md +30 -0
- package/agents/skills/industry/telecom-networks.skill.md +30 -0
- package/agents/skills/ops/caching-strategy.skill.md +77 -0
- package/agents/skills/ops/capacity-planning.skill.md +67 -0
- package/agents/skills/ops/cloud-deploy.skill.md +55 -0
- package/agents/skills/ops/configuration-management.skill.md +107 -0
- package/agents/skills/ops/cost-optimization.skill.md +39 -0
- package/agents/skills/ops/decommission-sunset.skill.md +64 -0
- package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
- package/agents/skills/ops/deployment.skill.md +217 -0
- package/agents/skills/ops/dev-environments.skill.md +31 -0
- package/agents/skills/ops/dev-workflow.skill.md +28 -0
- package/agents/skills/ops/docker-dev.skill.md +52 -0
- package/agents/skills/ops/enterprise-integration.skill.md +53 -0
- package/agents/skills/ops/feature-flag-management.skill.md +59 -0
- package/agents/skills/ops/incident-response.skill.md +40 -0
- package/agents/skills/ops/infra-devops.skill.md +53 -0
- package/agents/skills/ops/k8s-dev.skill.md +51 -0
- package/agents/skills/ops/memory-optimization.skill.md +45 -0
- package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
- package/agents/skills/ops/performance-audit.skill.md +178 -0
- package/agents/skills/ops/performance-optimization.skill.md +51 -0
- package/agents/skills/ops/production-health.skill.md +85 -0
- package/agents/skills/ops/production-verifier.skill.md +50 -0
- package/agents/skills/ops/queue-management.skill.md +52 -0
- package/agents/skills/ops/release-management.skill.md +39 -0
- package/agents/skills/ops/release-validation.skill.md +51 -0
- package/agents/skills/ops/reliability-sre.skill.md +51 -0
- package/agents/skills/ops/runbook-authoring.skill.md +64 -0
- package/agents/skills/ops/system-benchmark.skill.md +69 -0
- package/agents/skills/ops/tech-debt.skill.md +143 -0
- package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
- package/agents/skills/product/accessibility.skill.md +143 -0
- package/agents/skills/product/adr-writer.skill.md +110 -0
- package/agents/skills/product/business-case.skill.md +70 -0
- package/agents/skills/product/change-management.skill.md +90 -0
- package/agents/skills/product/decompose.skill.md +75 -0
- package/agents/skills/product/design-thinking.skill.md +62 -0
- package/agents/skills/product/estimation-sizing.skill.md +87 -0
- package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
- package/agents/skills/product/financial-governance.skill.md +88 -0
- package/agents/skills/product/green-software.skill.md +46 -0
- package/agents/skills/product/ideation-facilitation.skill.md +87 -0
- package/agents/skills/product/market-analysis.skill.md +56 -0
- package/agents/skills/product/opportunity-assessment.skill.md +89 -0
- package/agents/skills/product/product-analytics.skill.md +92 -0
- package/agents/skills/product/professional-practice.skill.md +105 -0
- package/agents/skills/product/req-elicitation.skill.md +292 -0
- package/agents/skills/product/req-review.skill.md +280 -0
- package/agents/skills/product/spec-analyze.skill.md +98 -0
- package/agents/skills/product/spec-writer.skill.md +114 -0
- package/agents/skills/product/stakeholder-management.skill.md +54 -0
- package/agents/skills/product/sustainability-checks.skill.md +29 -0
- package/agents/skills/product/systems-thinking.skill.md +56 -0
- package/agents/skills/product/user-research-synthesis.skill.md +85 -0
- package/agents/skills/product/user-story-mapping.skill.md +54 -0
- package/agents/skills/product/visual-specs.skill.md +112 -0
- package/agents/skills/security/access-control.skill.md +45 -0
- package/agents/skills/security/agent-sandboxing.skill.md +69 -0
- package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
- package/agents/skills/security/ai-red-teaming.skill.md +74 -0
- package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
- package/agents/skills/security/api-security.skill.md +31 -0
- package/agents/skills/security/backup-recovery.skill.md +49 -0
- package/agents/skills/security/compliance-review.skill.md +152 -0
- package/agents/skills/security/cryptography-standards.skill.md +31 -0
- package/agents/skills/security/dependency-security.skill.md +47 -0
- package/agents/skills/security/hazard-analysis.skill.md +53 -0
- package/agents/skills/security/legal-review.skill.md +41 -0
- package/agents/skills/security/log-analysis.skill.md +68 -0
- package/agents/skills/security/network-security.skill.md +64 -0
- package/agents/skills/security/privacy-audit.skill.md +137 -0
- package/agents/skills/security/privacy-data-protection.skill.md +31 -0
- package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
- package/agents/skills/security/reliability-engineering.skill.md +47 -0
- package/agents/skills/security/safety-scan.skill.md +49 -0
- package/agents/skills/security/secrets-management.skill.md +65 -0
- package/agents/skills/security/secure-architecture.skill.md +31 -0
- package/agents/skills/security/security-audit.skill.md +164 -0
- package/agents/skills/security/threat-model.skill.md +120 -0
- package/agents/skills/security/traceability-audit.skill.md +48 -0
- package/agents/templates/00-index.md +162 -0
- package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
- package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
- package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
- package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
- package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
- package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
- package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
- package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
- package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
- package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
- package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
- package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
- package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
- package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
- package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
- package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
- package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
- package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
- package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
- package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
- package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
- package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
- package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
- package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
- package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
- package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
- package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
- package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
- package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
- package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
- package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
- package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
- package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
- package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
- package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
- package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
- package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
- package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
- package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
- package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
- package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
- package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
- package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
- package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
- package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
- package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
- package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
- package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
- package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
- package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
- package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
- package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
- package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
- package/agents/templates/core/SDLC_TRACKER.md +217 -0
- package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
- package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
- package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
- package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
- package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
- package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
- package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
- package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
- package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
- package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
- package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
- package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
- package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
- package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
- package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
- package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
- package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
- package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
- package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
- package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
- package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
- package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
- package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
- package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
- package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
- package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
- package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
- package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
- package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
- package/agents/templates/product/NFR_TEMPLATE.md +31 -0
- package/agents/templates/product/PRD_TEMPLATE.md +222 -0
- package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
- package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
- package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
- package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
- package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
- package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
- package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
- package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
- package/agents/templates/security/HAZARD_LOG.md +17 -0
- package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
- package/agents/templates/security/SAFETY_CASE.md +39 -0
- package/agents/templates/security/SAFETY_POLICY.md +25 -0
- package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
- package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
- package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
- package/bin/install.js +572 -0
- package/docs/CLI_REFERENCE.md +527 -0
- package/docs/INSTALL.md +68 -0
- package/docs/MCP_CONFIGURATIONS.md +1765 -0
- package/docs/PLATFORM_CONTROLS.md +324 -0
- package/docs/POST_INSTALL.md +75 -0
- package/docs/QUICK_COMMANDS.md +131 -0
- package/docs/QUICK_GUIDE.md +914 -0
- package/docs/README_FULL.md +1451 -0
- package/docs/SCHEMA.md +164 -0
- package/docs/V1_RELEASE_CHECKLIST.md +144 -0
- package/docs/VERIFICATION_GUIDE.md +283 -0
- package/docs/adr/0001-record-architecture-decisions.md +26 -0
- package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
- package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
- package/docs/assets/GABBE.png +0 -0
- package/docs/gabbe.config.example.json +9 -0
- package/docs/reports/duplication-report.md +30 -0
- package/install.ps1 +90 -0
- package/install.sh +89 -0
- package/package.json +49 -0
- package/scripts/init.py +1036 -0
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
# Technical Specification: [Feature Name]
|
|
2
|
+
<!-- Derived from: PRD.md — do not start before PRD is approved -->
|
|
3
|
+
<!-- Created by: prod-architect / agent | Date: [date] -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Overview
|
|
8
|
+
|
|
9
|
+
**Feature:** [Name from PRD]
|
|
10
|
+
**PRD Reference:** [link to PRD.md]
|
|
11
|
+
**SDLC Phase:** S03 — Specification
|
|
12
|
+
**Spec author:** [agent/human]
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 2. Architecture Impact
|
|
17
|
+
|
|
18
|
+
**Affected layers:**
|
|
19
|
+
- [ ] Domain (new entities, value objects, domain events)
|
|
20
|
+
- [ ] Application (new use cases, command/query handlers)
|
|
21
|
+
- [ ] Adapters (new controllers, presenters, gateways)
|
|
22
|
+
- [ ] Infrastructure (new repository implementations, external API clients)
|
|
23
|
+
- [ ] Main/Bootstrap (new wiring)
|
|
24
|
+
|
|
25
|
+
**New services/modules:**
|
|
26
|
+
- `[ModuleName]` — [brief purpose]
|
|
27
|
+
|
|
28
|
+
**Modified existing files:**
|
|
29
|
+
- `[file path]` — [what changes]
|
|
30
|
+
|
|
31
|
+
**New files to create:**
|
|
32
|
+
- `[file path]` — [purpose]
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 3. Database Changes
|
|
37
|
+
|
|
38
|
+
### New Tables
|
|
39
|
+
```sql
|
|
40
|
+
CREATE TABLE [table_name] (
|
|
41
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
42
|
+
[field] [type] NOT NULL,
|
|
43
|
+
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
|
44
|
+
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
|
45
|
+
);
|
|
46
|
+
|
|
47
|
+
CREATE INDEX idx_[table]_[field] ON [table_name]([field]);
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Modified Tables
|
|
51
|
+
```sql
|
|
52
|
+
-- Migration: [migration_name]
|
|
53
|
+
ALTER TABLE [table_name] ADD COLUMN [field] [type] [constraints];
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Rollback Plan
|
|
57
|
+
```sql
|
|
58
|
+
-- Rollback
|
|
59
|
+
ALTER TABLE [table_name] DROP COLUMN IF EXISTS [field];
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### ORM Schema (Prisma example)
|
|
63
|
+
```prisma
|
|
64
|
+
model [ModelName] {
|
|
65
|
+
id String @id @default(uuid())
|
|
66
|
+
[field] [Type]
|
|
67
|
+
createdAt DateTime @default(now())
|
|
68
|
+
updatedAt DateTime @updatedAt
|
|
69
|
+
|
|
70
|
+
@@map("[table_name]")
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 4. API Contracts
|
|
77
|
+
|
|
78
|
+
### Endpoints
|
|
79
|
+
|
|
80
|
+
#### POST /api/v1/[resource]
|
|
81
|
+
```yaml
|
|
82
|
+
Request:
|
|
83
|
+
Content-Type: application/json
|
|
84
|
+
Authorization: Bearer {token}
|
|
85
|
+
Body:
|
|
86
|
+
[field]: string (required, max: 255)
|
|
87
|
+
[field]: string (required, email format)
|
|
88
|
+
|
|
89
|
+
Response 201 Created:
|
|
90
|
+
Content-Type: application/json
|
|
91
|
+
Body:
|
|
92
|
+
id: uuid
|
|
93
|
+
[field]: string
|
|
94
|
+
createdAt: ISO 8601 datetime
|
|
95
|
+
|
|
96
|
+
Response 422 Unprocessable Entity:
|
|
97
|
+
Body:
|
|
98
|
+
error:
|
|
99
|
+
code: "VALIDATION_ERROR"
|
|
100
|
+
message: "Validation failed"
|
|
101
|
+
details:
|
|
102
|
+
- field: "[field_name]"
|
|
103
|
+
code: "REQUIRED"
|
|
104
|
+
message: "[field] is required"
|
|
105
|
+
|
|
106
|
+
Response 401 Unauthorized:
|
|
107
|
+
Body:
|
|
108
|
+
error:
|
|
109
|
+
code: "UNAUTHORIZED"
|
|
110
|
+
message: "Authentication required"
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 5. Domain Model
|
|
116
|
+
|
|
117
|
+
### Entities
|
|
118
|
+
|
|
119
|
+
```typescript
|
|
120
|
+
// src/domain/[entity].ts
|
|
121
|
+
interface [Entity] {
|
|
122
|
+
id: string; // UUID
|
|
123
|
+
[field]: string; // [constraints]
|
|
124
|
+
createdAt: Date;
|
|
125
|
+
updatedAt: Date;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// Domain invariants:
|
|
129
|
+
// - [field] must be [constraint]
|
|
130
|
+
// - [entity] cannot be [invalid state]
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### Domain Events
|
|
134
|
+
|
|
135
|
+
```typescript
|
|
136
|
+
// Events emitted by this feature
|
|
137
|
+
interface [EntityCreatedEvent] {
|
|
138
|
+
type: '[ENTITY]_CREATED';
|
|
139
|
+
payload: { id: string; [field]: string; };
|
|
140
|
+
occurredAt: Date;
|
|
141
|
+
}
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### Value Objects
|
|
145
|
+
|
|
146
|
+
```typescript
|
|
147
|
+
// src/domain/value-objects/[name].ts
|
|
148
|
+
class [ValueObjectName] {
|
|
149
|
+
private readonly value: string;
|
|
150
|
+
|
|
151
|
+
private constructor(value: string) {
|
|
152
|
+
this.value = value;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
static create(value: string): Result<[ValueObjectName], ValidationError> {
|
|
156
|
+
if (!isValid(value)) {
|
|
157
|
+
return Result.fail(new ValidationError('[validation message]'));
|
|
158
|
+
}
|
|
159
|
+
return Result.ok(new [ValueObjectName](value));
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
toString(): string { return this.value; }
|
|
163
|
+
}
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 6. Use Cases / Application Services
|
|
169
|
+
|
|
170
|
+
```typescript
|
|
171
|
+
// src/application/[feature]/[action]-[entity].use-case.ts
|
|
172
|
+
|
|
173
|
+
interface [Action][Entity]Command {
|
|
174
|
+
[field]: string;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
interface [Action][Entity]Result {
|
|
178
|
+
id: string;
|
|
179
|
+
[field]: string;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
class [Action][Entity]UseCase {
|
|
183
|
+
constructor(
|
|
184
|
+
private readonly [entity]Repository: I[Entity]Repository,
|
|
185
|
+
private readonly eventBus: IEventBus,
|
|
186
|
+
) {}
|
|
187
|
+
|
|
188
|
+
async execute(command: [Action][Entity]Command): Promise<[Action][Entity]Result> {
|
|
189
|
+
// 1. Validate input (domain validation)
|
|
190
|
+
// 2. Apply business rules
|
|
191
|
+
// 3. Persist via repository
|
|
192
|
+
// 4. Emit domain event
|
|
193
|
+
// 5. Return result DTO
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## 7. Testing Strategy
|
|
201
|
+
|
|
202
|
+
### Unit Tests
|
|
203
|
+
```
|
|
204
|
+
src/domain/[entity].test.ts
|
|
205
|
+
- validates [field] format correctly
|
|
206
|
+
- rejects invalid [field] values
|
|
207
|
+
- domain event is emitted on creation
|
|
208
|
+
|
|
209
|
+
src/application/[feature]/[action]-[entity].use-case.test.ts
|
|
210
|
+
- creates [entity] with valid input
|
|
211
|
+
- returns 422 when [field] is invalid
|
|
212
|
+
- calls repository.save() with correct data
|
|
213
|
+
- emits [ENTITY_CREATED] event on success
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
### Integration Tests
|
|
217
|
+
```
|
|
218
|
+
tests/integration/api/[resource].test.ts
|
|
219
|
+
- POST /api/v1/[resource] with valid body returns 201
|
|
220
|
+
- POST /api/v1/[resource] with missing field returns 422
|
|
221
|
+
- POST /api/v1/[resource] without auth returns 401
|
|
222
|
+
- GET /api/v1/[resource] returns paginated list
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### Coverage Target
|
|
226
|
+
- Domain layer: > 99%
|
|
227
|
+
- Application layer: > 85%
|
|
228
|
+
- Adapters layer: > 99% (integration tests)
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
## 8. Security Decisions
|
|
233
|
+
|
|
234
|
+
**Authentication:** [JWT / Session / API Key / None]
|
|
235
|
+
**Authorization:** [RBAC rules — who can access this endpoint]
|
|
236
|
+
**Input validation:** [Zod schema / FormRequest / validator.js]
|
|
237
|
+
**Rate limiting:** [X requests/minute per IP / per user]
|
|
238
|
+
**Data sanitization:** [HTML entities escaped / SQL parameterized]
|
|
239
|
+
|
|
240
|
+
**Threat model reference:** [link to docs/security/threat-models/]
|
|
241
|
+
|
|
242
|
+
---
|
|
243
|
+
|
|
244
|
+
## 9. Feature Flags / Rollout
|
|
245
|
+
|
|
246
|
+
**Feature flag:** [Yes/No — flag name if yes]
|
|
247
|
+
**Rollout strategy:** [All users at once / Percentage rollout / Internal only first]
|
|
248
|
+
**Rollback trigger:** [Error rate > X% / manual decision]
|
|
249
|
+
|
|
250
|
+
---
|
|
251
|
+
|
|
252
|
+
## 10. Approval
|
|
253
|
+
|
|
254
|
+
| Role | Name | Status | Date |
|
|
255
|
+
|---|---|---|---|
|
|
256
|
+
| Tech Lead | [name] | [APPROVED / PENDING] | [date] |
|
|
257
|
+
| Security | [name] | [APPROVED / PENDING] | [date] |
|
|
258
|
+
|
|
259
|
+
**Human approval required before proceeding to Tasks phase (S04).**
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# Stakeholder Register — [System Name]
|
|
2
|
+
<!-- Created by: req-elicitation.skill or prod-pm persona -->
|
|
3
|
+
<!-- Referenced by: PRD.md, ARCHITECTURE_REVIEW_TEMPLATE.md -->
|
|
4
|
+
<!-- Update when: new stakeholders identified, roles change, concerns evolve -->
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Meta
|
|
9
|
+
|
|
10
|
+
| Field | Value |
|
|
11
|
+
|---|---|
|
|
12
|
+
| **System / Feature** | [system or feature name] |
|
|
13
|
+
| **Version** | [1.0] |
|
|
14
|
+
| **Date** | [YYYY-MM-DD] |
|
|
15
|
+
| **Author** | [agent/human] |
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Stakeholder Categories
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
Direct Users: People who directly operate or use the system
|
|
23
|
+
Indirect Users: People affected by system outputs without operating it
|
|
24
|
+
System Owners: People accountable for the system's existence and funding
|
|
25
|
+
External Systems: Other systems (automated actors) that integrate
|
|
26
|
+
Regulators: Authorities with compliance requirements over the system
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Stakeholder Register
|
|
32
|
+
|
|
33
|
+
| ID | Name / Role | Category | Goals | Concerns | Influence | Interest | Communication |
|
|
34
|
+
|---|---|---|---|---|---|---|---|
|
|
35
|
+
| SH-001 | [Role name e.g. "End Customer"] | Direct User | [What they want to achieve] | [What they fear or care about most] | H/M/L | H/M/L | [How/when to communicate with them] |
|
|
36
|
+
| SH-002 | [Role name e.g. "Operations Team"] | Direct User | | | | | |
|
|
37
|
+
| SH-003 | [Role name e.g. "Product Owner"] | System Owner | | | | | |
|
|
38
|
+
| SH-004 | [External system name] | External System | | | | | |
|
|
39
|
+
| SH-005 | [Regulatory body] | Regulator | | | | | |
|
|
40
|
+
|
|
41
|
+
**Influence**: How much can they change system direction?
|
|
42
|
+
**Interest**: How affected are they by system outcomes?
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Stakeholder Engagement Matrix
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
High Interest + High Influence → MANAGE CLOSELY (primary stakeholders)
|
|
50
|
+
High Interest + Low Influence → KEEP INFORMED
|
|
51
|
+
Low Interest + High Influence → KEEP SATISFIED
|
|
52
|
+
Low Interest + Low Influence → MONITOR (minimal effort)
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
| Stakeholder | Interest | Influence | Engagement Strategy |
|
|
56
|
+
|---|---|---|---|
|
|
57
|
+
| [SH-001] | H | H | MANAGE CLOSELY — weekly updates, approval gates |
|
|
58
|
+
| [SH-002] | H | L | KEEP INFORMED — bi-weekly reports |
|
|
59
|
+
| [SH-003] | L | H | KEEP SATISFIED — milestone reviews |
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Stakeholder Concerns Catalog
|
|
64
|
+
|
|
65
|
+
For each primary stakeholder, document their key concerns:
|
|
66
|
+
|
|
67
|
+
### SH-001: [Role Name]
|
|
68
|
+
|
|
69
|
+
**Goals:**
|
|
70
|
+
- [Primary objective 1]
|
|
71
|
+
- [Primary objective 2]
|
|
72
|
+
|
|
73
|
+
**Concerns / Fears:**
|
|
74
|
+
- [What they're afraid the system will do wrong]
|
|
75
|
+
- [What risks worry them]
|
|
76
|
+
|
|
77
|
+
**Success Criteria:**
|
|
78
|
+
- [How this stakeholder knows the system succeeded]
|
|
79
|
+
- [Measurable: "Order confirmation received within 30 seconds"]
|
|
80
|
+
|
|
81
|
+
**Required Consultations:**
|
|
82
|
+
- [Phase S01 requirements approval]
|
|
83
|
+
- [Phase S08 final review]
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
### SH-002: [Role Name]
|
|
88
|
+
|
|
89
|
+
**Goals:**
|
|
90
|
+
-
|
|
91
|
+
|
|
92
|
+
**Concerns / Fears:**
|
|
93
|
+
-
|
|
94
|
+
|
|
95
|
+
**Success Criteria:**
|
|
96
|
+
-
|
|
97
|
+
|
|
98
|
+
**Required Consultations:**
|
|
99
|
+
-
|
|
100
|
+
|
|
101
|
+
<!-- Repeat for each primary stakeholder (Influence=H or Interest=H) -->
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## Conflicting Concerns
|
|
106
|
+
|
|
107
|
+
Document any stakeholder concerns that conflict with each other:
|
|
108
|
+
|
|
109
|
+
| Conflict | SH-A concern | SH-B concern | Resolution approach |
|
|
110
|
+
|---|---|---|---|
|
|
111
|
+
| [Conflict 1] | [SH-001 wants X] | [SH-003 wants not-X] | [How to resolve or escalate] |
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## Stakeholder Sign-off Requirements
|
|
116
|
+
|
|
117
|
+
| Phase Gate | Required Sign-off | Stakeholder |
|
|
118
|
+
|---|---|---|
|
|
119
|
+
| S01 — Requirements | Approval of PRD.md | [SH-001, SH-003] |
|
|
120
|
+
| S02 — Architecture | Approval of PLAN.md | [SH-003] |
|
|
121
|
+
| S08 — Human Review | Final code/product review | [SH-003] |
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Notes
|
|
126
|
+
|
|
127
|
+
[Any additional context about stakeholders, organizational dynamics, or communication constraints]
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# User Story Map
|
|
2
|
+
|
|
3
|
+
**Product**: [Name]
|
|
4
|
+
**Date**: [YYYY-MM-DD]
|
|
5
|
+
**Goal**: [e.g., MVP Launch]
|
|
6
|
+
|
|
7
|
+
## 1. The Backbone (User Journey)
|
|
8
|
+
| Activity 1 (Sign Up) | Activity 2 (Search) | Activity 3 (Purchase) | Activity 4 (Admin) |
|
|
9
|
+
|---|---|---|---|
|
|
10
|
+
|
|
11
|
+
## 2. Release Slicing
|
|
12
|
+
|
|
13
|
+
### Release 1: The "Walking Skeleton" (MVP)
|
|
14
|
+
*Goal: Proof of Value, End-to-End connectivity*
|
|
15
|
+
- [ ] [Sign Up] Register with Email
|
|
16
|
+
- [ ] [Search] By Keyword
|
|
17
|
+
- [ ] [Purchase] Credit Card (Stripe)
|
|
18
|
+
- [ ] [Admin] View Orders
|
|
19
|
+
|
|
20
|
+
### Release 2: The "Marketable Product" (v1.0)
|
|
21
|
+
*Goal: Optimization and Retention*
|
|
22
|
+
- [ ] [Sign Up] Google SSO
|
|
23
|
+
- [ ] [Search] Filters (Price, Date)
|
|
24
|
+
- [ ] [Purchase] PayPal, Saved Cards
|
|
25
|
+
- [ ] [Admin] Refund Orders
|
|
26
|
+
|
|
27
|
+
### Release 3: The "Scale" (v2.0)
|
|
28
|
+
*Goal: Enterprise features*
|
|
29
|
+
- [ ] [Sign Up] SAML / SSO
|
|
30
|
+
- [ ] [Search] AI Recommendation
|
|
31
|
+
- [ ] [Admin] Analytics Dashboard
|
|
32
|
+
|
|
33
|
+
## 3. Assumptions & Risks
|
|
34
|
+
- [ ] Assumption: Stripe approval takes < 2 days.
|
|
35
|
+
- [ ] Risk: Search latency might be high for v1 without Elasticsearch.
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
# Visual Spec Package: [Project Name]
|
|
2
|
+
|
|
3
|
+
<!-- Complete visual design artifacts — fill before proceeding to implementation -->
|
|
4
|
+
<!-- Created by: visual-specs.skill | Date: [date] -->
|
|
5
|
+
<!-- Depends on: Approved PRD (S01) -->
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. System Architecture
|
|
10
|
+
|
|
11
|
+
### 1.1 C4 Context Diagram
|
|
12
|
+
<!-- High-level: system boundary, external actors, neighboring systems -->
|
|
13
|
+
<!-- Use Mermaid for simple (<15 nodes), Excalidraw for complex -->
|
|
14
|
+
|
|
15
|
+
**Diagram file**: [path to .excalidraw / .drawio or Mermaid below]
|
|
16
|
+
|
|
17
|
+
```mermaid
|
|
18
|
+
%% Replace with actual C4 Context diagram
|
|
19
|
+
flowchart TD
|
|
20
|
+
User[External User] --> System[System Name]
|
|
21
|
+
System --> DB[(Database)]
|
|
22
|
+
System --> ExtAPI[External API]
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### 1.2 C4 Container Diagram (if multi-service)
|
|
26
|
+
<!-- Internal containers: services, databases, message queues, etc. -->
|
|
27
|
+
|
|
28
|
+
**Diagram file**: [path or Mermaid below]
|
|
29
|
+
|
|
30
|
+
### 1.3 C4 Component Diagram (if complex service)
|
|
31
|
+
<!-- Internal components within a single container -->
|
|
32
|
+
|
|
33
|
+
**Diagram file**: [path or Mermaid below]
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 2. Workflow & State Diagrams
|
|
38
|
+
|
|
39
|
+
### 2.1 Primary User Flow
|
|
40
|
+
<!-- Main happy-path workflow from user action to system response -->
|
|
41
|
+
|
|
42
|
+
**Diagram file**: [path or Mermaid below]
|
|
43
|
+
|
|
44
|
+
```mermaid
|
|
45
|
+
%% Replace with actual flowchart
|
|
46
|
+
flowchart TD
|
|
47
|
+
A[Start] --> B{Decision?}
|
|
48
|
+
B -->|Yes| C[Action A]
|
|
49
|
+
B -->|No| D[Action B]
|
|
50
|
+
C --> E[End]
|
|
51
|
+
D --> E
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### 2.2 State Machine: [Entity Name]
|
|
55
|
+
<!-- For entities with >3 states — orders, payments, sessions, etc. -->
|
|
56
|
+
|
|
57
|
+
**Diagram file**: [path or Mermaid below]
|
|
58
|
+
|
|
59
|
+
```mermaid
|
|
60
|
+
%% Replace with actual state diagram
|
|
61
|
+
stateDiagram-v2
|
|
62
|
+
[*] --> Draft
|
|
63
|
+
Draft --> Submitted: submit()
|
|
64
|
+
Submitted --> Approved: approve()
|
|
65
|
+
Submitted --> Rejected: reject()
|
|
66
|
+
Approved --> [*]
|
|
67
|
+
Rejected --> Draft: revise()
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### 2.3 Additional Workflows
|
|
71
|
+
<!-- Error flows, admin flows, batch processes, etc. -->
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 3. UI/UX Design
|
|
76
|
+
|
|
77
|
+
### 3.1 Key Screen Wireframes
|
|
78
|
+
<!-- Use tldraw for wireframes, Figma for high-fidelity -->
|
|
79
|
+
|
|
80
|
+
| Screen | Wireframe File | Description |
|
|
81
|
+
|---|---|---|
|
|
82
|
+
| [Login] | [path/to/login.tldr] | [Email/password form, OAuth buttons] |
|
|
83
|
+
| [Dashboard] | [path/to/dashboard.tldr] | [Summary cards, recent activity] |
|
|
84
|
+
| [Detail Page] | [path/to/detail.tldr] | [Entity details, edit form, actions] |
|
|
85
|
+
|
|
86
|
+
### 3.2 Screen Flow / Navigation
|
|
87
|
+
<!-- How screens connect — page navigation map -->
|
|
88
|
+
|
|
89
|
+
**Diagram file**: [path or Mermaid below]
|
|
90
|
+
|
|
91
|
+
```mermaid
|
|
92
|
+
%% Replace with actual navigation flow
|
|
93
|
+
flowchart LR
|
|
94
|
+
Login --> Dashboard
|
|
95
|
+
Dashboard --> Detail
|
|
96
|
+
Dashboard --> Settings
|
|
97
|
+
Detail --> Edit
|
|
98
|
+
Edit --> Detail
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### 3.3 Component Hierarchy
|
|
102
|
+
<!-- Reusable UI components and their nesting -->
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 4. Data Model
|
|
107
|
+
|
|
108
|
+
### 4.1 ER Diagram
|
|
109
|
+
<!-- Entity-Relationship model for persistent storage -->
|
|
110
|
+
|
|
111
|
+
**Diagram file**: [path or Mermaid below]
|
|
112
|
+
|
|
113
|
+
```mermaid
|
|
114
|
+
%% Replace with actual ER diagram
|
|
115
|
+
erDiagram
|
|
116
|
+
USER ||--o{ ORDER : places
|
|
117
|
+
ORDER ||--|{ LINE_ITEM : contains
|
|
118
|
+
LINE_ITEM }|--|| PRODUCT : references
|
|
119
|
+
USER {
|
|
120
|
+
uuid id PK
|
|
121
|
+
string email UK
|
|
122
|
+
string name
|
|
123
|
+
timestamp created_at
|
|
124
|
+
}
|
|
125
|
+
ORDER {
|
|
126
|
+
uuid id PK
|
|
127
|
+
uuid user_id FK
|
|
128
|
+
string status
|
|
129
|
+
decimal total
|
|
130
|
+
timestamp created_at
|
|
131
|
+
}
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### 4.2 Data Flow
|
|
135
|
+
<!-- How data moves through the system — input → processing → storage → output -->
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 5. Use Cases & Interactions
|
|
140
|
+
|
|
141
|
+
### 5.1 Sequence Diagram: [Primary Use Case]
|
|
142
|
+
<!-- Actor-system interaction for the main flow -->
|
|
143
|
+
|
|
144
|
+
**Diagram file**: [path or Mermaid below]
|
|
145
|
+
|
|
146
|
+
```mermaid
|
|
147
|
+
%% Replace with actual sequence diagram
|
|
148
|
+
sequenceDiagram
|
|
149
|
+
actor User
|
|
150
|
+
participant Frontend
|
|
151
|
+
participant API
|
|
152
|
+
participant DB
|
|
153
|
+
User->>Frontend: Submit form
|
|
154
|
+
Frontend->>API: POST /api/resource
|
|
155
|
+
API->>DB: INSERT record
|
|
156
|
+
DB-->>API: OK
|
|
157
|
+
API-->>Frontend: 201 Created
|
|
158
|
+
Frontend-->>User: Success message
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### 5.2 Additional Use Cases
|
|
162
|
+
<!-- Error scenarios, admin use cases, batch operations -->
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 6. Visual Input Log
|
|
167
|
+
|
|
168
|
+
<!-- Track all original visual inputs and their recognition results -->
|
|
169
|
+
|
|
170
|
+
| # | Input Image | Type | Recognition Result | Output Diagram | Confidence |
|
|
171
|
+
|---|---|---|---|---|---|
|
|
172
|
+
| 1 | [path/to/whiteboard.jpg] | Architecture | [Recognized N nodes, M edges] | [path/to/arch.excalidraw] | [HIGH/MED/LOW] |
|
|
173
|
+
| 2 | [path/to/wireframe.jpg] | UI Wireframe | [Recognized N elements] | [path/to/screens.tldr] | [HIGH/MED/LOW] |
|
|
174
|
+
| 3 | [path/to/flowchart.jpg] | Flowchart | [Recognized N steps, M decisions] | [Mermaid in Section 2] | [HIGH/MED/LOW] |
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## 7. Design Readiness Checklist
|
|
179
|
+
|
|
180
|
+
**All required items must pass before proceeding to S02 Architecture / S03 Implementation.**
|
|
181
|
+
|
|
182
|
+
### Required
|
|
183
|
+
- [ ] System architecture diagram (C4 Context minimum) — present and human-verified
|
|
184
|
+
- [ ] Primary user workflow diagrammed (flowchart/sequence)
|
|
185
|
+
- [ ] Data model / ER diagram documented (if persistent storage involved)
|
|
186
|
+
- [ ] All user-provided visual inputs processed and documented in Section 6
|
|
187
|
+
- [ ] All diagrams committed to version control
|
|
188
|
+
|
|
189
|
+
### Recommended (for UI-facing projects)
|
|
190
|
+
- [ ] UI wireframes for key screens created (tldraw/Figma)
|
|
191
|
+
- [ ] Screen flow / navigation diagram present
|
|
192
|
+
- [ ] Component hierarchy documented
|
|
193
|
+
|
|
194
|
+
### Optional (for complex systems)
|
|
195
|
+
- [ ] State diagrams for entities with >3 states
|
|
196
|
+
- [ ] Sequence diagrams for cross-service interactions
|
|
197
|
+
- [ ] Deployment / infrastructure diagram
|
|
198
|
+
- [ ] Use case diagram for actor-system boundaries
|
|
199
|
+
|
|
200
|
+
### Approval
|
|
201
|
+
| Role | Name | Status | Date |
|
|
202
|
+
|---|---|---|---|
|
|
203
|
+
| Product | [name] | [APPROVED / PENDING] | [date] |
|
|
204
|
+
| Engineering | [name] | [APPROVED / PENDING] | [date] |
|
|
205
|
+
| Design | [name] | [APPROVED / PENDING] | [date] |
|
|
206
|
+
|
|
207
|
+
**Human approval required before proceeding to Architecture/Implementation phase.**
|