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,59 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design-patterns
|
|
3
|
+
description: Identifies, implements, and refactors code using standard Design Patterns (GoF + Modern).
|
|
4
|
+
triggers: [design pattern, refactor pattern, strategy pattern, observer pattern, factory pattern, singleton]
|
|
5
|
+
tags: [architecture]
|
|
6
|
+
context_cost: low
|
|
7
|
+
---
|
|
8
|
+
# Design Patterns Skill
|
|
9
|
+
|
|
10
|
+
## Goal
|
|
11
|
+
To improve code maintainability, flexibility, and readability by applying proven solutions to common design problems.
|
|
12
|
+
|
|
13
|
+
## Supported Patterns (2025 Context)
|
|
14
|
+
|
|
15
|
+
### Creational
|
|
16
|
+
- **Factory / Builder**: For complex object construction (e.g., configuring LLM clients).
|
|
17
|
+
- **Singleton**: Use sparingly (e.g., for Database connections or Logging service).
|
|
18
|
+
|
|
19
|
+
### Structural
|
|
20
|
+
- **Adapter**: Connecting legacy code or external APIs (e.g., standardizing different LLM APIs).
|
|
21
|
+
- **Facade**: Simplifying complex subsystems (e.g., a simple `WebScraper` class wrapping Puppeteer).
|
|
22
|
+
- **Composite**: For tree structures (e.g., parsing code ASTs).
|
|
23
|
+
|
|
24
|
+
### Behavioral
|
|
25
|
+
- **Strategy**: Swappable algorithms (e.g., switching between 'Fast' and 'Smart' search).
|
|
26
|
+
- **Observer**: Event handling (e.g., updating UI when data changes).
|
|
27
|
+
- **State**: Managing complex entity lifecycles (e.g., Order status: Pending -> Paid -> Shipped).
|
|
28
|
+
|
|
29
|
+
### Modern / Cloud
|
|
30
|
+
- **Circuit Breaker**: Preventing cascading failures in distributed calls.
|
|
31
|
+
- **Sidecar**: Offloading infra concerns (logging, proxying) to a separate process/container.
|
|
32
|
+
- **BFF (Backend for Frontend)**: API layer tailored to specific UIs.
|
|
33
|
+
|
|
34
|
+
## Steps
|
|
35
|
+
1. **Identify the Problem**: "I have a lot of `if/else` statements for different payment methods."
|
|
36
|
+
2. **Match Pattern**: "This looks like a use case for the **Strategy Pattern**."
|
|
37
|
+
3. **Refactor**:
|
|
38
|
+
- Define the Interface.
|
|
39
|
+
- Implement Concrete Strategies.
|
|
40
|
+
- Inject the Strategy into the Context.
|
|
41
|
+
4. **Document**: Add a comment or use `DESIGN_PATTERN_USAGE.md` if complex.
|
|
42
|
+
|
|
43
|
+
## Anti-Patterns to Avoid
|
|
44
|
+
- **God Object**: Class that does everything.
|
|
45
|
+
- **Golden Hammer**: Using the same pattern everywhere (e.g., everything is a Singleton).
|
|
46
|
+
|
|
47
|
+
## Security & Guardrails
|
|
48
|
+
|
|
49
|
+
### 1. Skill Security (Design Patterns)
|
|
50
|
+
- **Pattern Implementation Integrity**: When the agent generates code for complex patterns like `Facade` or `Adapter`, it must not inadvertently bypass existing security checks. For example, if an `Adapter` wraps an older API, the agent must ensure it does not accidentally strip out authentication headers or input sanitization routines present in the original call chain.
|
|
51
|
+
- **Singleton State Exhaustion**: If the agent implements a `Singleton` for a shared resource (like a DB connection pool), it must explicitly define maximum bounds and timeout values. An unbound Singleton can be exploited to cause a Denial of Service (DoS) by exhausting memory or connections globally across the application.
|
|
52
|
+
|
|
53
|
+
### 2. System Integration Security
|
|
54
|
+
- **Proxy/Sidecar Bypass**: When the architecture uses a `Sidecar` or `BFF` for security concerns (like TLS termination or global rate limiting), the agent must physically or logically isolate the backend service so it ONLY accepts traffic from the Sidecar/BFF. Any network configuration allowing a direct request to the backend service bypasses the security pattern entirely.
|
|
55
|
+
- **Observer Data Leakage**: In the `Observer` pattern, state changes are broadcast to all subscribed listeners. The agent must verify that sensitive data (e.g., unhashed passwords, PII) is scrubbed from the event payload *before* it is broadcast, ensuring that an arbitrary internal listener cannot silently capture regulated data.
|
|
56
|
+
|
|
57
|
+
### 3. LLM & Agent Guardrails
|
|
58
|
+
- **Complexity-Driven Vulnerabilities**: The LLM might propose an overly convoluted combination of `Strategy`, `Factory`, and `Decorator` patterns to solve a simple problem. This extreme abstraction (the "Lasagna Architecture") makes it nearly impossible for human reviewers to trace the execution flow and identify authorization bugs. The agent must prioritize the "Keep It Simple, Stupid" (KISS) principle for security-critical pathways.
|
|
59
|
+
- **Hallucinated Thread-Safety**: The agent must definitively know the concurrency model of the target language. If the agent generates a `Singleton` in a multi-threaded language (like Java or Go), it is strictly forbidden from generating naive, thread-unsafe initializations which could lead to race conditions and unpredictable authorization state.
|
|
@@ -0,0 +1,380 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "diagramming"
|
|
3
|
+
description: Choose and create the right diagram type (UML, C4, ER, BPMN, domain) in standard notation; Mermaid-compatible output.
|
|
4
|
+
triggers: ["create diagram", "draw diagram", "which diagram", "diagram this", "visualize", "sequence diagram", "class diagram", "flowchart", "architecture diagram", "ER diagram", "state diagram", "activity diagram", "context diagram", "swimlane"]
|
|
5
|
+
tags: ["architecture"]
|
|
6
|
+
context_cost: "low"
|
|
7
|
+
---
|
|
8
|
+
# Diagramming Skill
|
|
9
|
+
|
|
10
|
+
## Goal
|
|
11
|
+
|
|
12
|
+
Select the appropriate diagram type for the communication need, create it using correct
|
|
13
|
+
notation and standards, and produce output in Mermaid syntax (or PlantUML as fallback).
|
|
14
|
+
Diagrams are communication tools — choose based on what question the reader needs answered.
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Diagram Selection Guide
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
Question being answered → Diagram type
|
|
22
|
+
|
|
23
|
+
"What IS the system and who uses it?" → System Context (C4 Level 1)
|
|
24
|
+
"What are the major deployable parts?" → Container Diagram (C4 Level 2)
|
|
25
|
+
"What are the components inside a container?" → Component Diagram (C4 Level 3)
|
|
26
|
+
"How are business objects structured?" → Domain Class Diagram
|
|
27
|
+
"How are data tables related?" → Entity-Relationship Diagram
|
|
28
|
+
"What packages/modules exist?" → Package Diagram
|
|
29
|
+
"How does process X flow step by step?" → Sequence Diagram
|
|
30
|
+
"What are all the paths through a use case?" → Activity Diagram
|
|
31
|
+
"What states can object X be in?" → State Machine Diagram
|
|
32
|
+
"Who does what in a process?" → Swimlane Diagram (BPMN or Activity)
|
|
33
|
+
"How does the business process work end-to-end?" → BPMN Process Diagram
|
|
34
|
+
"What are all the use cases for an actor?" → Use Case Diagram
|
|
35
|
+
"Where is the system deployed physically?" → Deployment Diagram (C4 or UML)
|
|
36
|
+
"How does data flow through the system?" → Data Flow Diagram (DFD)
|
|
37
|
+
"What are the business capabilities?" → Capability Map
|
|
38
|
+
"How do domains relate to each other?" → Context Map
|
|
39
|
+
"What happened in what order (events)?" → Event Storming / Timeline
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Diagram Standards by Type
|
|
45
|
+
|
|
46
|
+
### C4 Architecture Diagrams (Mermaid C4)
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
Level of abstraction:
|
|
50
|
+
Level 1 — System Context: whole system as one box + external actors
|
|
51
|
+
Level 2 — Container: major deployable units (apps, databases, services)
|
|
52
|
+
Level 3 — Component: major components inside ONE container
|
|
53
|
+
Level 4 — Code: class/entity level (use sparingly)
|
|
54
|
+
|
|
55
|
+
Rules:
|
|
56
|
+
- Each diagram has ONE level of zoom
|
|
57
|
+
- Include title, description for each element
|
|
58
|
+
- Show communication protocol on relationship arrows
|
|
59
|
+
- External systems in grey/different color
|
|
60
|
+
- Boundary boxes for systems
|
|
61
|
+
|
|
62
|
+
Mermaid C4 syntax:
|
|
63
|
+
C4Context, C4Container, C4Component, C4Deployment
|
|
64
|
+
Person(), System(), System_Ext(), Container(), ContainerDb()
|
|
65
|
+
Rel(from, to, "label", "protocol")
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**Mermaid C4 Context Example:**
|
|
69
|
+
```mermaid
|
|
70
|
+
C4Context
|
|
71
|
+
title System Context — Order Management System
|
|
72
|
+
Person(customer, "Customer", "Registered user placing orders")
|
|
73
|
+
Person(admin, "Admin", "Internal staff managing orders")
|
|
74
|
+
System(oms, "Order Management", "Handles order lifecycle")
|
|
75
|
+
System_Ext(payment, "Payment Gateway", "Processes payments")
|
|
76
|
+
System_Ext(email, "Email Service", "Sends notifications")
|
|
77
|
+
Rel(customer, oms, "Places orders", "HTTPS")
|
|
78
|
+
Rel(admin, oms, "Manages orders", "HTTPS")
|
|
79
|
+
Rel(oms, payment, "Charges customer", "HTTPS/API")
|
|
80
|
+
Rel(oms, email, "Sends confirmation", "HTTPS")
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
### Sequence Diagram (interaction over time)
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
Use when: showing how components/actors interact in a specific scenario.
|
|
89
|
+
Strengths: clear temporal ordering, shows synchronous vs async, highlights round-trips.
|
|
90
|
+
|
|
91
|
+
Rules:
|
|
92
|
+
- Show ONE use case scenario per diagram (not all scenarios in one)
|
|
93
|
+
- Label all arrows with the operation/message name
|
|
94
|
+
- Use activation bars for synchronous calls
|
|
95
|
+
- Show return messages explicitly (dashed arrows)
|
|
96
|
+
- Use alt/opt/loop for conditional flows
|
|
97
|
+
|
|
98
|
+
Anti-patterns:
|
|
99
|
+
- Too many actors (> 6) — split into smaller diagrams
|
|
100
|
+
- Showing all edge cases in one diagram — use separate diagrams
|
|
101
|
+
- Missing return arrows — always show response
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
**Mermaid Sequence Example:**
|
|
105
|
+
```mermaid
|
|
106
|
+
sequenceDiagram
|
|
107
|
+
autonumber
|
|
108
|
+
actor Customer
|
|
109
|
+
participant OrderService
|
|
110
|
+
participant InventoryService
|
|
111
|
+
participant PaymentGateway
|
|
112
|
+
|
|
113
|
+
Customer->>OrderService: POST /orders {items, paymentToken}
|
|
114
|
+
OrderService->>InventoryService: checkStock(items)
|
|
115
|
+
InventoryService-->>OrderService: stockAvailable: true
|
|
116
|
+
OrderService->>PaymentGateway: chargeCard(paymentToken, amount)
|
|
117
|
+
PaymentGateway-->>OrderService: paymentConfirmed: {transactionId}
|
|
118
|
+
OrderService-->>Customer: 201 Created {orderId}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
### State Machine Diagram (object lifecycle)
|
|
124
|
+
|
|
125
|
+
```
|
|
126
|
+
Use when: showing all valid states an entity can be in and transitions between them.
|
|
127
|
+
Strengths: captures business rules about what transitions are allowed.
|
|
128
|
+
|
|
129
|
+
Rules:
|
|
130
|
+
- Start state: filled circle (●)
|
|
131
|
+
- End state: filled circle with ring (⊙)
|
|
132
|
+
- Transitions labeled with: trigger [guard condition] / action
|
|
133
|
+
- Every state should be reachable from start
|
|
134
|
+
- Every non-terminal state should have at least one exit
|
|
135
|
+
|
|
136
|
+
Anti-patterns:
|
|
137
|
+
- Missing guard conditions (ambiguous transitions)
|
|
138
|
+
- No final state (infinite loop entity)
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
**Mermaid State Example:**
|
|
142
|
+
```mermaid
|
|
143
|
+
stateDiagram-v2
|
|
144
|
+
[*] --> Pending : OrderPlaced
|
|
145
|
+
Pending --> Confirmed : PaymentReceived
|
|
146
|
+
Pending --> Cancelled : PaymentFailed / timeout
|
|
147
|
+
Confirmed --> Shipped : FulfilmentCompleted
|
|
148
|
+
Confirmed --> Cancelled : CustomerCancelled [before shipping]
|
|
149
|
+
Shipped --> Delivered : DeliveryConfirmed
|
|
150
|
+
Shipped --> ReturnRequested : CustomerReturns
|
|
151
|
+
Delivered --> ReturnRequested : CustomerReturns [within 30 days]
|
|
152
|
+
ReturnRequested --> Refunded : ReturnReceived
|
|
153
|
+
Cancelled --> [*]
|
|
154
|
+
Delivered --> [*]
|
|
155
|
+
Refunded --> [*]
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
### Entity-Relationship Diagram (data model)
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
Use when: showing data model — tables, entities, and relationships.
|
|
164
|
+
Strengths: precise notation for cardinality, clear data ownership.
|
|
165
|
+
|
|
166
|
+
Cardinality notation (Chen / crow's foot):
|
|
167
|
+
||--|| : exactly one to exactly one
|
|
168
|
+
||--o{ : exactly one to zero-or-more
|
|
169
|
+
}o--o{ : zero-or-more to zero-or-more
|
|
170
|
+
||--|{ : exactly one to one-or-more
|
|
171
|
+
|
|
172
|
+
Rules:
|
|
173
|
+
- Every entity has a primary key attribute
|
|
174
|
+
- Relationship lines include cardinality
|
|
175
|
+
- Attribute names use domain language (not column names)
|
|
176
|
+
- Foreign key relationships shown as lines, not as duplicate attributes
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
**Mermaid ER Example:**
|
|
180
|
+
```mermaid
|
|
181
|
+
erDiagram
|
|
182
|
+
CUSTOMER ||--o{ ORDER : "places"
|
|
183
|
+
ORDER ||--|{ ORDER_ITEM : "contains"
|
|
184
|
+
PRODUCT ||--o{ ORDER_ITEM : "included in"
|
|
185
|
+
CUSTOMER {
|
|
186
|
+
uuid id PK
|
|
187
|
+
string email
|
|
188
|
+
string name
|
|
189
|
+
timestamp createdAt
|
|
190
|
+
}
|
|
191
|
+
ORDER {
|
|
192
|
+
uuid id PK
|
|
193
|
+
uuid customerId FK
|
|
194
|
+
string status
|
|
195
|
+
decimal total
|
|
196
|
+
timestamp placedAt
|
|
197
|
+
}
|
|
198
|
+
ORDER_ITEM {
|
|
199
|
+
uuid id PK
|
|
200
|
+
uuid orderId FK
|
|
201
|
+
uuid productId FK
|
|
202
|
+
int quantity
|
|
203
|
+
decimal unitPrice
|
|
204
|
+
}
|
|
205
|
+
PRODUCT {
|
|
206
|
+
uuid id PK
|
|
207
|
+
string name
|
|
208
|
+
decimal price
|
|
209
|
+
int stockQuantity
|
|
210
|
+
}
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
### Activity / Flowchart (process flow)
|
|
216
|
+
|
|
217
|
+
```
|
|
218
|
+
Use when: showing decision logic, algorithmic flow, or business process steps.
|
|
219
|
+
Strengths: clear decision branches, parallelism notation.
|
|
220
|
+
|
|
221
|
+
Rules:
|
|
222
|
+
- Start and end nodes clearly marked
|
|
223
|
+
- Decision nodes (diamond) have labeled branches for each outcome
|
|
224
|
+
- Parallel flows shown with fork/join bars
|
|
225
|
+
- Use swimlanes to show who does what
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
**Mermaid Flowchart Example:**
|
|
229
|
+
```mermaid
|
|
230
|
+
flowchart TD
|
|
231
|
+
A([Start: Order Received]) --> B{Inventory Check}
|
|
232
|
+
B -->|Available| C[Reserve Inventory]
|
|
233
|
+
B -->|Unavailable| D[Notify Customer: Out of Stock]
|
|
234
|
+
D --> Z([End: Order Cancelled])
|
|
235
|
+
C --> E{Payment Processing}
|
|
236
|
+
E -->|Success| F[Confirm Order]
|
|
237
|
+
E -->|Failure| G{Retry count < 3?}
|
|
238
|
+
G -->|Yes| E
|
|
239
|
+
G -->|No| H[Release Inventory]
|
|
240
|
+
H --> I[Notify Customer: Payment Failed]
|
|
241
|
+
I --> Z
|
|
242
|
+
F --> J[Schedule Fulfilment]
|
|
243
|
+
J --> K[Send Confirmation Email]
|
|
244
|
+
K --> Z2([End: Order Confirmed])
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
### Data Flow Diagram (DFD)
|
|
250
|
+
|
|
251
|
+
```
|
|
252
|
+
Use when: showing how data moves through a system across processes and stores.
|
|
253
|
+
DFD uses a specific notation:
|
|
254
|
+
External Entity: rectangle (data source/sink outside system)
|
|
255
|
+
Process: rounded rectangle or circle (transforms data)
|
|
256
|
+
Data Store: open-ended rectangle (persistent storage)
|
|
257
|
+
Data Flow: labeled arrow (data moving)
|
|
258
|
+
|
|
259
|
+
Levels:
|
|
260
|
+
Level 0 (Context DFD): System as one process, all external entities, all data flows
|
|
261
|
+
Level 1 (System DFD): Explode main process into sub-processes
|
|
262
|
+
Level 2: Explode one sub-process further (only if needed)
|
|
263
|
+
|
|
264
|
+
Rules:
|
|
265
|
+
- Data stores: data at rest (not processes)
|
|
266
|
+
- Processes: always transform input to output (labeled as verb phrases)
|
|
267
|
+
- All flows must be labeled with what data flows
|
|
268
|
+
- External entities: actors or systems outside system boundary
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
**DFD in Mermaid (approximation using flowchart):**
|
|
272
|
+
```mermaid
|
|
273
|
+
flowchart LR
|
|
274
|
+
Customer([Customer])
|
|
275
|
+
Admin([Admin])
|
|
276
|
+
subgraph "Order System"
|
|
277
|
+
P1[Process Order]
|
|
278
|
+
P2[Validate Payment]
|
|
279
|
+
P3[Update Inventory]
|
|
280
|
+
DS1[(Order Store)]
|
|
281
|
+
DS2[(Product Store)]
|
|
282
|
+
end
|
|
283
|
+
PaymentGateway([Payment Gateway])
|
|
284
|
+
|
|
285
|
+
Customer -->|"Order Request"| P1
|
|
286
|
+
P1 -->|"Payment Details"| P2
|
|
287
|
+
P2 -->|"Charge Request"| PaymentGateway
|
|
288
|
+
PaymentGateway -->|"Payment Result"| P2
|
|
289
|
+
P2 -->|"Confirmed Order"| DS1
|
|
290
|
+
P1 -->|"Stock Query"| DS2
|
|
291
|
+
DS2 -->|"Stock Level"| P1
|
|
292
|
+
P2 -->|"Reserve Items"| P3
|
|
293
|
+
P3 -->|"Updated Stock"| DS2
|
|
294
|
+
Admin -->|"Inventory Update"| P3
|
|
295
|
+
DS1 -->|"Order Confirmation"| Customer
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
---
|
|
299
|
+
|
|
300
|
+
### Context Map Diagram (domain relationships)
|
|
301
|
+
|
|
302
|
+
```
|
|
303
|
+
Use when: showing how bounded contexts relate to each other.
|
|
304
|
+
See domain-model.skill.md for context map patterns.
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
**Mermaid Context Map Example:**
|
|
308
|
+
```mermaid
|
|
309
|
+
graph TB
|
|
310
|
+
subgraph "Order Management [U]"
|
|
311
|
+
OM[Order Management]
|
|
312
|
+
end
|
|
313
|
+
subgraph "Identity [U]"
|
|
314
|
+
IAM[Identity & Access]
|
|
315
|
+
end
|
|
316
|
+
subgraph "Payment [U]"
|
|
317
|
+
PAY[Payment]
|
|
318
|
+
end
|
|
319
|
+
subgraph "Notification [D]"
|
|
320
|
+
NOT[Notification]
|
|
321
|
+
end
|
|
322
|
+
subgraph "Catalog [U]"
|
|
323
|
+
CAT[Product Catalog]
|
|
324
|
+
end
|
|
325
|
+
|
|
326
|
+
IAM -->|"OHS/PL\nUser Identity API"| OM
|
|
327
|
+
CAT -->|"OHS/PL\nProduct API"| OM
|
|
328
|
+
OM -->|"Customer/Supplier\nPayment Intent"| PAY
|
|
329
|
+
OM -->|"OHS\nOrderEvent"| NOT
|
|
330
|
+
PAY -->|"Published Language\nPaymentEvent"| NOT
|
|
331
|
+
|
|
332
|
+
style OM fill:#dae8fc
|
|
333
|
+
style IAM fill:#d5e8d4
|
|
334
|
+
style PAY fill:#d5e8d4
|
|
335
|
+
style CAT fill:#d5e8d4
|
|
336
|
+
style NOT fill:#fff2cc
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
---
|
|
340
|
+
|
|
341
|
+
## Diagram Review Checklist
|
|
342
|
+
|
|
343
|
+
```
|
|
344
|
+
Before finalizing any diagram:
|
|
345
|
+
□ Title: is there a clear, descriptive title?
|
|
346
|
+
□ Scope: is it clear what's IN and what's OUTSIDE the diagram?
|
|
347
|
+
□ Labels: are all elements and arrows labeled clearly?
|
|
348
|
+
□ Legend: does the diagram need a legend for custom notation?
|
|
349
|
+
□ Level: is this diagram one consistent level of abstraction?
|
|
350
|
+
□ Audience: would the target reader understand it without explanation?
|
|
351
|
+
□ Accuracy: does this match the actual system (not wishful thinking)?
|
|
352
|
+
□ Completeness: are all significant elements shown?
|
|
353
|
+
□ Clutter: is there anything that can be removed to improve clarity?
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
---
|
|
357
|
+
|
|
358
|
+
## Constraints
|
|
359
|
+
|
|
360
|
+
- One diagram = one question answered. Do not mix levels of abstraction.
|
|
361
|
+
- Diagrams must match reality — no aspirational architecture in current-state diagrams
|
|
362
|
+
- Prefer Mermaid for text-based portability (renders in GitHub, VS Code, Notion)
|
|
363
|
+
- If Mermaid can't represent the diagram type, describe in structured text with explicit notation
|
|
364
|
+
- Include diagram title and date — diagrams without metadata become unreliable
|
|
365
|
+
- Simple is better — if a diagram needs extensive explanation, simplify the diagram
|
|
366
|
+
|
|
367
|
+
## Security & Guardrails
|
|
368
|
+
|
|
369
|
+
### Steps
|
|
370
|
+
## 1. Skill Security (Diagramming)
|
|
371
|
+
- **Visual IP Leakage**: The agent must not include highly specific, sensitive configuration details (e.g., hardcoded IP subnets, plaintext API keys, precise firewall port numbers) within the generated Mermaid diagrams. Diagrams act as a high-level topographical map; embedding literal secrets turns the documentation into a target for credential scraping.
|
|
372
|
+
- **Malicious Syntax Injection**: The agent must sanitize any user-provided names or labels before injecting them into Mermaid or PlantUML syntax. An attacker providing a component name like `"); DROP TABLE users;` must not be able to break the markdown renderer or cause HTML injection/XSS when the diagram is visualized in a browser.
|
|
373
|
+
|
|
374
|
+
### 2. System Integration Security
|
|
375
|
+
- **Threat Model Anchoring**: When generating a System Context (Level 1) or Container (Level 2) diagram, the agent must ensure that all external boundaries and trust domains align perfectly with the application's Threat Model. A diagram that omits an external third-party service creates a blind spot where zero security controls will be applied.
|
|
376
|
+
- **Data Classification in DFDs**: When creating Data Flow Diagrams (DFDs), the agent should distinguish the flow of highly sensitive data (e.g., marking PCI/PHI flows in red or with specific labels). This provides visual proof to auditors that regulated data is exclusively traversing encrypted, approved pathways.
|
|
377
|
+
|
|
378
|
+
### 3. LLM & Agent Guardrails
|
|
379
|
+
- **Aspirational Architecture Bias**: The LLM might hallucinate security components (e.g., drawing a "WAF" or "KMS" box) simply because it mathematically associates them with enterprise deployments, even if they explicitly do not exist in the current system. The agent must strictly adhere to rendering *only* the verified, ground-truth architecture, preventing a false sense of security.
|
|
380
|
+
- **Protocol Hallucination**: The agent must accurately reflect communication protocols (e.g., `HTTPS` vs `HTTP`, `TLS` vs `TCP`). If the agent "guesses" that an internal connection uses `HTTPS` when it actually uses plaintext `HTTP`, it actively orchestrates a critical vulnerability misrepresentation. If the protocol is unknown, it must be labeled `[UNKNOWN]`, not assumed secure.
|