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,568 @@
|
|
|
1
|
+
# Guide: Diagramming Standards
|
|
2
|
+
<!-- When to use which diagram type, notation standards, Mermaid syntax reference -->
|
|
3
|
+
<!-- Diagram families: UML, C4, ER, BPMN, DFD, Domain, Infrastructure -->
|
|
4
|
+
<!-- Technology-agnostic. All diagrams expressed in Mermaid where possible. -->
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## The Golden Rule of Diagrams
|
|
9
|
+
|
|
10
|
+
**One diagram answers ONE question for ONE audience.**
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
Before drawing: ask "What question does this diagram answer?"
|
|
14
|
+
If no clear answer → don't draw it.
|
|
15
|
+
If the answer requires 2+ questions → split into 2 diagrams.
|
|
16
|
+
|
|
17
|
+
Good question: "What external actors interact with our system?" → System Context
|
|
18
|
+
Bad question: "Everything about our system" → No single diagram type
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Diagram Selection Decision Tree
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
Q: What are you trying to show?
|
|
27
|
+
|
|
28
|
+
├── System structure / architecture
|
|
29
|
+
│ ├── Who uses it and what external systems interact?
|
|
30
|
+
│ │ → System Context Diagram (C4 Level 1)
|
|
31
|
+
│ ├── What are the major deployable units?
|
|
32
|
+
│ │ → Container Diagram (C4 Level 2)
|
|
33
|
+
│ ├── What components are inside one container?
|
|
34
|
+
│ │ → Component Diagram (C4 Level 3)
|
|
35
|
+
│ ├── How are classes/entities related in code?
|
|
36
|
+
│ │ → Class Diagram (UML)
|
|
37
|
+
│ └── How do packages/modules depend on each other?
|
|
38
|
+
│ → Package Diagram (UML) / Module Dependency Map
|
|
39
|
+
│
|
|
40
|
+
├── Runtime behavior / interactions
|
|
41
|
+
│ ├── How do components/actors interact over time for one scenario?
|
|
42
|
+
│ │ → Sequence Diagram (UML)
|
|
43
|
+
│ ├── What decision logic or process flow?
|
|
44
|
+
│ │ → Activity Diagram (UML) / Flowchart
|
|
45
|
+
│ ├── What states can an object be in?
|
|
46
|
+
│ │ → State Machine Diagram (UML)
|
|
47
|
+
│ └── How does a business process work end-to-end?
|
|
48
|
+
│ → BPMN Process Diagram / Swimlane
|
|
49
|
+
│
|
|
50
|
+
├── Data
|
|
51
|
+
│ ├── How are data entities related? (schema-level)
|
|
52
|
+
│ │ → Entity-Relationship Diagram (ER)
|
|
53
|
+
│ └── How does data flow through the system? (process-level)
|
|
54
|
+
│ → Data Flow Diagram (DFD)
|
|
55
|
+
│
|
|
56
|
+
├── Deployment / infrastructure
|
|
57
|
+
│ └── Where does the system run?
|
|
58
|
+
│ → Deployment Diagram (C4 Deployment or UML)
|
|
59
|
+
│
|
|
60
|
+
└── Domain / business
|
|
61
|
+
├── How do bounded contexts relate?
|
|
62
|
+
│ → Context Map
|
|
63
|
+
├── What business capabilities exist?
|
|
64
|
+
│ → Capability Map
|
|
65
|
+
├── What happened in what order?
|
|
66
|
+
│ → Event Storming / Timeline
|
|
67
|
+
└── Who does what, who makes decisions?
|
|
68
|
+
→ Use Case Diagram (UML) or RACI Matrix
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## C4 Architecture Diagrams
|
|
74
|
+
|
|
75
|
+
The C4 model provides 4 levels of abstraction for software architecture.
|
|
76
|
+
Each level answers a different question for a different audience.
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
Level 1 — System Context:
|
|
80
|
+
Question: Who uses the system? What external systems interact?
|
|
81
|
+
Audience: Everyone — business, technical, non-technical
|
|
82
|
+
Scope: The entire system as one box
|
|
83
|
+
|
|
84
|
+
Level 2 — Container:
|
|
85
|
+
Question: What are the major deployable units?
|
|
86
|
+
Audience: Technical (developers, architects, DevOps)
|
|
87
|
+
Scope: Inside the system boundary — one step of zoom
|
|
88
|
+
|
|
89
|
+
Level 3 — Component:
|
|
90
|
+
Question: What are the major components inside ONE container?
|
|
91
|
+
Audience: Technical (developers, architects)
|
|
92
|
+
Scope: Inside one container
|
|
93
|
+
|
|
94
|
+
Level 4 — Code:
|
|
95
|
+
Question: How is one component implemented internally?
|
|
96
|
+
Audience: Developers (code author's immediate team)
|
|
97
|
+
Scope: Classes, interfaces, functions
|
|
98
|
+
Note: Use sparingly — code changes too fast to maintain L4 diagrams
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### C4 Mermaid Syntax
|
|
102
|
+
|
|
103
|
+
```mermaid
|
|
104
|
+
%% Level 1 — System Context
|
|
105
|
+
C4Context
|
|
106
|
+
title System Context — [Name]
|
|
107
|
+
Person(id, "Label", "Description")
|
|
108
|
+
Person_Ext(id, "Label", "Description") %% external person
|
|
109
|
+
System(id, "Label", "Description")
|
|
110
|
+
System_Ext(id, "Label", "Description") %% external system
|
|
111
|
+
SystemDb(id, "Label", "Description") %% database system
|
|
112
|
+
Rel(from, to, "Label", "Protocol")
|
|
113
|
+
Rel_Back(from, to, "Label") %% reverse arrow
|
|
114
|
+
UpdateLayoutConfig($c4ShapeInRow="3")
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
```mermaid
|
|
118
|
+
%% Level 2 — Containers
|
|
119
|
+
C4Container
|
|
120
|
+
title Container Diagram — [Name]
|
|
121
|
+
Person(user, "User")
|
|
122
|
+
System_Boundary(sys, "System Name") {
|
|
123
|
+
Container(id, "Label", "Technology", "Description")
|
|
124
|
+
ContainerDb(id, "Label", "Technology", "Description")
|
|
125
|
+
ContainerQueue(id, "Label", "Technology", "Description")
|
|
126
|
+
}
|
|
127
|
+
System_Ext(ext, "External System")
|
|
128
|
+
Rel(from, to, "Label", "Protocol")
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## UML Structural Diagrams
|
|
134
|
+
|
|
135
|
+
### Class / Domain Diagram
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
Use when: showing the structure of domain objects, their attributes, and relationships.
|
|
139
|
+
In architecture context: use for domain model documentation (not database schema).
|
|
140
|
+
|
|
141
|
+
Relationship notation:
|
|
142
|
+
Association: A → B (A uses B)
|
|
143
|
+
Dependency: A --> B (A depends on B, weaker)
|
|
144
|
+
Aggregation: A <>-- B (B is part of A, but exists independently)
|
|
145
|
+
Composition: A *-- B (B is owned by A, destroyed with A)
|
|
146
|
+
Inheritance: A <|-- B (B extends A)
|
|
147
|
+
Realization: A <|.. B (B implements A's interface)
|
|
148
|
+
|
|
149
|
+
Multiplicity:
|
|
150
|
+
1 exactly one
|
|
151
|
+
0..1 zero or one
|
|
152
|
+
* zero or many
|
|
153
|
+
1..* one or many
|
|
154
|
+
N..M between N and M
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
```mermaid
|
|
158
|
+
classDiagram
|
|
159
|
+
class Order {
|
|
160
|
+
+OrderId id
|
|
161
|
+
+CustomerId customerId
|
|
162
|
+
+OrderStatus status
|
|
163
|
+
+Money total
|
|
164
|
+
+place() void
|
|
165
|
+
+confirm(paymentId) void
|
|
166
|
+
+cancel(reason) void
|
|
167
|
+
}
|
|
168
|
+
class OrderItem {
|
|
169
|
+
+ProductId productId
|
|
170
|
+
+int quantity
|
|
171
|
+
+Money unitPrice
|
|
172
|
+
+lineTotal() Money
|
|
173
|
+
}
|
|
174
|
+
class Money {
|
|
175
|
+
+decimal amount
|
|
176
|
+
+string currency
|
|
177
|
+
+add(Money) Money
|
|
178
|
+
}
|
|
179
|
+
class OrderStatus {
|
|
180
|
+
<<enumeration>>
|
|
181
|
+
PENDING
|
|
182
|
+
CONFIRMED
|
|
183
|
+
SHIPPED
|
|
184
|
+
DELIVERED
|
|
185
|
+
CANCELLED
|
|
186
|
+
}
|
|
187
|
+
Order "1" *-- "1..*" OrderItem : contains
|
|
188
|
+
Order --> Money : totals to
|
|
189
|
+
OrderItem --> Money : priced in
|
|
190
|
+
Order --> OrderStatus : has
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
### Package / Module Diagram
|
|
194
|
+
|
|
195
|
+
```
|
|
196
|
+
Use when: showing how code is organized into modules and their dependencies.
|
|
197
|
+
Rules:
|
|
198
|
+
- Arrows show dependency direction (A → B means A imports/uses B)
|
|
199
|
+
- Cyclic dependencies (A → B → A) are architectural violations
|
|
200
|
+
- Group related packages into namespace boundaries
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
```mermaid
|
|
204
|
+
graph LR
|
|
205
|
+
subgraph "Presentation Layer"
|
|
206
|
+
HTTP[HTTP Controllers]
|
|
207
|
+
end
|
|
208
|
+
subgraph "Application Layer"
|
|
209
|
+
UC[Use Cases]
|
|
210
|
+
end
|
|
211
|
+
subgraph "Domain Layer"
|
|
212
|
+
DOM[Domain Entities]
|
|
213
|
+
IFACE[Repository Interfaces]
|
|
214
|
+
end
|
|
215
|
+
subgraph "Infrastructure Layer"
|
|
216
|
+
REPO[Repository Implementations]
|
|
217
|
+
EXT[External Service Clients]
|
|
218
|
+
end
|
|
219
|
+
|
|
220
|
+
HTTP --> UC
|
|
221
|
+
UC --> DOM
|
|
222
|
+
UC --> IFACE
|
|
223
|
+
REPO --> IFACE
|
|
224
|
+
REPO --> DOM
|
|
225
|
+
EXT --> DOM
|
|
226
|
+
HTTP -.->|"FORBIDDEN"| REPO
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
## UML Behavioral Diagrams
|
|
232
|
+
|
|
233
|
+
### Sequence Diagram
|
|
234
|
+
|
|
235
|
+
```
|
|
236
|
+
Use when: showing how actors/components interact for ONE specific scenario.
|
|
237
|
+
Best for: API flows, use case implementation, integration sequences.
|
|
238
|
+
|
|
239
|
+
Rules:
|
|
240
|
+
- One scenario per diagram (not all scenarios combined)
|
|
241
|
+
- Show actors (people) as stick figures; components as boxes
|
|
242
|
+
- Solid arrow: synchronous call (caller waits)
|
|
243
|
+
- Dashed arrow: return message
|
|
244
|
+
- Open arrowhead: async message (caller doesn't wait)
|
|
245
|
+
- Activation bars: show when an object is active
|
|
246
|
+
- Use alt/opt/loop for conditional branches (keep simple — split if complex)
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
```mermaid
|
|
250
|
+
sequenceDiagram
|
|
251
|
+
autonumber
|
|
252
|
+
actor Customer
|
|
253
|
+
participant API as Order API
|
|
254
|
+
participant Inventory
|
|
255
|
+
participant Payment as Payment Gateway
|
|
256
|
+
|
|
257
|
+
Customer->>+API: POST /orders {items, paymentMethod}
|
|
258
|
+
|
|
259
|
+
API->>+Inventory: checkAvailability(items)
|
|
260
|
+
Inventory-->>-API: {available: true}
|
|
261
|
+
|
|
262
|
+
API->>+Payment: authorize(paymentMethod, total)
|
|
263
|
+
Payment-->>-API: {authorized: true, authCode}
|
|
264
|
+
|
|
265
|
+
API->>API: createOrder()
|
|
266
|
+
API-->>-Customer: 201 {orderId, status: "CONFIRMED"}
|
|
267
|
+
|
|
268
|
+
Note over API,Inventory: Async: reserve inventory after response
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
### State Machine Diagram
|
|
272
|
+
|
|
273
|
+
```
|
|
274
|
+
Use when: showing all valid states an entity can be in and how it transitions.
|
|
275
|
+
Best for: order lifecycle, user account states, subscription states.
|
|
276
|
+
|
|
277
|
+
Rules:
|
|
278
|
+
- [*]: initial state (filled circle) and final state (circle with ring)
|
|
279
|
+
- Transitions labeled with: event [guard] / action
|
|
280
|
+
- Every state must be reachable from the initial state
|
|
281
|
+
- No impossible transitions — every exit must have a guard if conditional
|
|
282
|
+
- Keep to ≤ 10 states per diagram; split complex lifecycles into sub-states
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
```mermaid
|
|
286
|
+
stateDiagram-v2
|
|
287
|
+
direction LR
|
|
288
|
+
[*] --> Pending : OrderPlaced
|
|
289
|
+
Pending --> Confirmed : PaymentReceived
|
|
290
|
+
Pending --> Cancelled : PaymentFailed\nor CustomerCancelled
|
|
291
|
+
Confirmed --> Processing : PickingStarted
|
|
292
|
+
Confirmed --> Cancelled : CustomerCancelled [before picking]
|
|
293
|
+
Processing --> Shipped : Dispatched
|
|
294
|
+
Shipped --> Delivered : DeliveryConfirmed
|
|
295
|
+
Shipped --> ReturnRequested : CustomerInitiatesReturn
|
|
296
|
+
Delivered --> ReturnRequested : CustomerInitiatesReturn [within 30 days]
|
|
297
|
+
ReturnRequested --> Refunded : ItemReturnedAndInspected
|
|
298
|
+
Delivered --> [*]
|
|
299
|
+
Refunded --> [*]
|
|
300
|
+
Cancelled --> [*]
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
### Activity Diagram / Flowchart
|
|
304
|
+
|
|
305
|
+
```
|
|
306
|
+
Use when: showing decision logic, process flow, algorithmic steps, or workflow.
|
|
307
|
+
Best for: business process documentation, algorithm description.
|
|
308
|
+
|
|
309
|
+
Rules:
|
|
310
|
+
- Start and end nodes clearly shown
|
|
311
|
+
- Decision diamonds: binary outcomes labeled on both exits
|
|
312
|
+
- Parallel flows: fork/join bars for concurrent activities
|
|
313
|
+
- Keep to one level — use sub-diagrams for complex sub-processes
|
|
314
|
+
- Action verb phrases for activity labels
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
```mermaid
|
|
318
|
+
flowchart TD
|
|
319
|
+
Start([Order Received]) --> ValidateInput{Input Valid?}
|
|
320
|
+
ValidateInput -- No --> ReturnError[Return 400 Error]
|
|
321
|
+
ReturnError --> End1([End])
|
|
322
|
+
ValidateInput -- Yes --> CheckInventory{Items Available?}
|
|
323
|
+
CheckInventory -- No --> NotifyUnavailable[Notify: Items Unavailable]
|
|
324
|
+
NotifyUnavailable --> End2([End: Cancelled])
|
|
325
|
+
CheckInventory -- Yes --> ProcessPayment{Payment OK?}
|
|
326
|
+
ProcessPayment -- No --> RetryPayment{Retries < 3?}
|
|
327
|
+
RetryPayment -- Yes --> ProcessPayment
|
|
328
|
+
RetryPayment -- No --> ReleaseInventory[Release Reserved Inventory]
|
|
329
|
+
ReleaseInventory --> NotifyFailed[Notify: Payment Failed]
|
|
330
|
+
NotifyFailed --> End3([End: Cancelled])
|
|
331
|
+
ProcessPayment -- Yes --> ConfirmOrder[Confirm Order]
|
|
332
|
+
ConfirmOrder --> SendConfirmation[Send Confirmation Email]
|
|
333
|
+
SendConfirmation --> End4([End: Confirmed])
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
---
|
|
337
|
+
|
|
338
|
+
## Entity-Relationship Diagrams (ER / Data Model)
|
|
339
|
+
|
|
340
|
+
```
|
|
341
|
+
Use when: documenting the data model — entities, attributes, and relationships.
|
|
342
|
+
Note: Use for logical/conceptual model, not physical DB schema.
|
|
343
|
+
Physical schema is implementation — ER is business model.
|
|
344
|
+
|
|
345
|
+
Cardinality (crow's foot notation):
|
|
346
|
+
||--|| : exactly one to exactly one
|
|
347
|
+
||--o{ : exactly one to zero-or-many
|
|
348
|
+
||--|{ : exactly one to one-or-many
|
|
349
|
+
}o--o{ : zero-or-many to zero-or-many
|
|
350
|
+
}|--|{ : one-or-many to one-or-many
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
```mermaid
|
|
354
|
+
erDiagram
|
|
355
|
+
CUSTOMER ||--o{ ORDER : "places"
|
|
356
|
+
ORDER ||--|{ ORDER_ITEM : "contains"
|
|
357
|
+
PRODUCT ||--o{ ORDER_ITEM : "referenced in"
|
|
358
|
+
ORDER }o--|| PAYMENT : "paid by"
|
|
359
|
+
|
|
360
|
+
CUSTOMER {
|
|
361
|
+
uuid customerId PK
|
|
362
|
+
string email "unique"
|
|
363
|
+
string fullName
|
|
364
|
+
date registeredAt
|
|
365
|
+
}
|
|
366
|
+
ORDER {
|
|
367
|
+
uuid orderId PK
|
|
368
|
+
uuid customerId FK
|
|
369
|
+
string status "PENDING|CONFIRMED|SHIPPED|DELIVERED|CANCELLED"
|
|
370
|
+
decimal totalAmount
|
|
371
|
+
datetime placedAt
|
|
372
|
+
}
|
|
373
|
+
ORDER_ITEM {
|
|
374
|
+
uuid itemId PK
|
|
375
|
+
uuid orderId FK
|
|
376
|
+
uuid productId FK
|
|
377
|
+
int quantity "min:1"
|
|
378
|
+
decimal unitPriceAtTime
|
|
379
|
+
}
|
|
380
|
+
PRODUCT {
|
|
381
|
+
uuid productId PK
|
|
382
|
+
string name
|
|
383
|
+
decimal currentPrice
|
|
384
|
+
int stockQuantity
|
|
385
|
+
}
|
|
386
|
+
PAYMENT {
|
|
387
|
+
uuid paymentId PK
|
|
388
|
+
uuid orderId FK
|
|
389
|
+
string status "PENDING|AUTHORIZED|CAPTURED|FAILED|REFUNDED"
|
|
390
|
+
decimal amount
|
|
391
|
+
datetime processedAt
|
|
392
|
+
}
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
---
|
|
396
|
+
|
|
397
|
+
## Data Flow Diagrams (DFD)
|
|
398
|
+
|
|
399
|
+
```
|
|
400
|
+
Use when: showing how data moves through a system — processes, stores, flows.
|
|
401
|
+
Best for: understanding data processing, compliance documentation.
|
|
402
|
+
|
|
403
|
+
DFD notation:
|
|
404
|
+
External Entity: rectangle (source or sink of data, outside system)
|
|
405
|
+
Process: rounded rectangle or circle (transforms data)
|
|
406
|
+
Data Store: parallel lines (persistent storage)
|
|
407
|
+
Data Flow: labeled arrow (data in motion)
|
|
408
|
+
|
|
409
|
+
Levels:
|
|
410
|
+
Level 0 (Context DFD): whole system as one process with all external entities
|
|
411
|
+
Level 1: Explode main process into sub-processes with their flows
|
|
412
|
+
Level 2+: Drill into sub-processes (use sparingly — only complex areas)
|
|
413
|
+
|
|
414
|
+
Mermaid approximation (no native DFD, use flowchart with shapes):
|
|
415
|
+
```
|
|
416
|
+
|
|
417
|
+
```mermaid
|
|
418
|
+
flowchart LR
|
|
419
|
+
Customer([Customer]):::ext
|
|
420
|
+
Admin([Admin]):::ext
|
|
421
|
+
PaymentGW([Payment Gateway]):::ext
|
|
422
|
+
|
|
423
|
+
subgraph "Order System"
|
|
424
|
+
P1([Process Order]):::process
|
|
425
|
+
P2([Validate Payment]):::process
|
|
426
|
+
P3([Manage Inventory]):::process
|
|
427
|
+
DS1[("Order Store")]:::store
|
|
428
|
+
DS2[("Product Store")]:::store
|
|
429
|
+
end
|
|
430
|
+
|
|
431
|
+
Customer -->|"Order Request"| P1
|
|
432
|
+
P1 -->|"Stock Query"| DS2
|
|
433
|
+
DS2 -->|"Stock Level"| P1
|
|
434
|
+
P1 -->|"Payment Details"| P2
|
|
435
|
+
P2 -->|"Charge Request"| PaymentGW
|
|
436
|
+
PaymentGW -->|"Auth Result"| P2
|
|
437
|
+
P2 -->|"Order Data"| DS1
|
|
438
|
+
P2 -->|"Reserve"| P3
|
|
439
|
+
P3 -->|"Updated Stock"| DS2
|
|
440
|
+
Admin -->|"Inventory Update"| P3
|
|
441
|
+
DS1 -->|"Confirmation"| Customer
|
|
442
|
+
|
|
443
|
+
classDef ext fill:#f9f,stroke:#333
|
|
444
|
+
classDef process fill:#bbf,stroke:#333
|
|
445
|
+
classDef store fill:#bfb,stroke:#333
|
|
446
|
+
```
|
|
447
|
+
|
|
448
|
+
---
|
|
449
|
+
|
|
450
|
+
## BPMN / Swimlane Diagrams
|
|
451
|
+
|
|
452
|
+
```
|
|
453
|
+
Use when: showing who does what in a business process — multiple actors.
|
|
454
|
+
Best for: business process modeling, regulatory documentation.
|
|
455
|
+
|
|
456
|
+
Swimlane rules:
|
|
457
|
+
- One lane per actor/role
|
|
458
|
+
- Activities (tasks): in the lane of who performs them
|
|
459
|
+
- Decision gates (diamonds): in the lane of who decides
|
|
460
|
+
- Sequence flows: connect activities across lanes with arrows
|
|
461
|
+
- Events (circles): start/end markers per lane
|
|
462
|
+
- External systems: typically represented as separate pools/lanes
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
```mermaid
|
|
466
|
+
flowchart LR
|
|
467
|
+
subgraph Customer
|
|
468
|
+
C1([Start]) --> C2[Browse & Add to Cart]
|
|
469
|
+
C2 --> C3[Checkout]
|
|
470
|
+
C3 --> C4{Payment OK?}
|
|
471
|
+
C4 -->|Yes| C5[Receive Confirmation]
|
|
472
|
+
C4 -->|No| C6[Update Payment]
|
|
473
|
+
C6 --> C3
|
|
474
|
+
end
|
|
475
|
+
subgraph "Order System"
|
|
476
|
+
OS1[Validate Order] --> OS2[Reserve Inventory]
|
|
477
|
+
OS2 --> OS3[Process Payment]
|
|
478
|
+
OS3 --> OS4{Payment Result}
|
|
479
|
+
OS4 -->|Success| OS5[Confirm Order]
|
|
480
|
+
OS4 -->|Fail| OS6[Release Inventory]
|
|
481
|
+
end
|
|
482
|
+
subgraph "Fulfilment"
|
|
483
|
+
F1[Pick Items] --> F2[Pack Order]
|
|
484
|
+
F2 --> F3[Ship]
|
|
485
|
+
F3 --> F4([End: Delivered])
|
|
486
|
+
end
|
|
487
|
+
|
|
488
|
+
C3 --> OS1
|
|
489
|
+
OS5 --> C5
|
|
490
|
+
OS6 --> C4
|
|
491
|
+
OS5 --> F1
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
---
|
|
495
|
+
|
|
496
|
+
## Diagram Review Checklist
|
|
497
|
+
|
|
498
|
+
Before finalizing any diagram:
|
|
499
|
+
|
|
500
|
+
```
|
|
501
|
+
Content:
|
|
502
|
+
□ Title: clear, descriptive, present tense ("Order Placement Flow")
|
|
503
|
+
□ Scope: what's IN the diagram is clear (system boundary, time boundary)
|
|
504
|
+
□ Audience: the diagram is pitched at the right level for its reader
|
|
505
|
+
□ Accuracy: reflects the ACTUAL system, not the aspirational system
|
|
506
|
+
□ Completeness: all significant elements included (not an exhaustive catalog)
|
|
507
|
+
|
|
508
|
+
Clarity:
|
|
509
|
+
□ All elements labeled (no unlabeled arrows or boxes)
|
|
510
|
+
□ Legend included if custom notation used
|
|
511
|
+
□ Consistent level of abstraction throughout (no mixing levels)
|
|
512
|
+
□ Key message visible at first glance (not buried in detail)
|
|
513
|
+
□ Clutter: anything that can be removed without loss? Remove it.
|
|
514
|
+
|
|
515
|
+
Maintenance:
|
|
516
|
+
□ Date/version noted on the diagram or in filename
|
|
517
|
+
□ Owner identified (who is responsible for keeping this current?)
|
|
518
|
+
□ Review trigger: "Update when [X] changes"
|
|
519
|
+
□ Source file (Mermaid code) stored with the diagram, not just the image
|
|
520
|
+
```
|
|
521
|
+
|
|
522
|
+
---
|
|
523
|
+
|
|
524
|
+
## Tool Recommendations
|
|
525
|
+
|
|
526
|
+
```
|
|
527
|
+
Mermaid: Text-based, renders in GitHub/GitLab/Notion/VS Code
|
|
528
|
+
Best for: C4, Sequence, State, ER, Flowchart, Class
|
|
529
|
+
Source: mermaid.js.org
|
|
530
|
+
|
|
531
|
+
PlantUML: Text-based, broader UML support, requires Java
|
|
532
|
+
Best for: complex UML, timing diagrams
|
|
533
|
+
Source: plantuml.com
|
|
534
|
+
|
|
535
|
+
draw.io (diagrams.net): GUI, XML-based, stores as XML in repo
|
|
536
|
+
Best for: freeform diagrams, whiteboards, mixed notation
|
|
537
|
+
Source: diagrams.net
|
|
538
|
+
|
|
539
|
+
Structurizr: Purpose-built C4 model tool
|
|
540
|
+
Best for: large system C4 diagrams with many views
|
|
541
|
+
Source: structurizr.com
|
|
542
|
+
|
|
543
|
+
Excalidraw: Collaborative whiteboard, hand-drawn style
|
|
544
|
+
Best for: early-stage exploration, event storming
|
|
545
|
+
Source: excalidraw.com
|
|
546
|
+
|
|
547
|
+
Lucidchart/Miro: Collaborative GUI tools
|
|
548
|
+
Best for: team workshops, stakeholder presentations
|
|
549
|
+
```
|
|
550
|
+
|
|
551
|
+
---
|
|
552
|
+
|
|
553
|
+
## Diagram Naming Conventions
|
|
554
|
+
|
|
555
|
+
```
|
|
556
|
+
File naming:
|
|
557
|
+
[system]-[view-type]-[context].md or .mermaid
|
|
558
|
+
|
|
559
|
+
Examples:
|
|
560
|
+
orderservice-sequence-place-order.md
|
|
561
|
+
platform-container-diagram.md
|
|
562
|
+
domain-context-map.md
|
|
563
|
+
customer-lifecycle-state-machine.md
|
|
564
|
+
data-model-order-management.md
|
|
565
|
+
|
|
566
|
+
Version in filename only if multiple significant versions need to coexist:
|
|
567
|
+
architecture-container-v2.md (v2 = major redesign)
|
|
568
|
+
```
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Evaluation Strategy Guide (for agentic / LLM systems)
|
|
2
|
+
|
|
3
|
+
When the system under construction is — or relies on — an LLM, "does it pass?" is the
|
|
4
|
+
wrong question. Output is probabilistic, so the right question is "how good is it, on
|
|
5
|
+
average, on the inputs we care about, and is it getting worse?". This guide covers how
|
|
6
|
+
GABBE evaluates probabilistic systems alongside its normal deterministic testing.
|
|
7
|
+
|
|
8
|
+
## 1. Tests vs Evals — two different jobs
|
|
9
|
+
|
|
10
|
+
These are complementary, not competing. You need both.
|
|
11
|
+
|
|
12
|
+
- **Tests** verify **determinism**. The same input must always produce the same output.
|
|
13
|
+
The verdict is binary pass/fail, it is cheap, and it runs on every commit/PR in CI. This
|
|
14
|
+
is everything in `testing-strategy.md` — static analysis, unit, integration, contract,
|
|
15
|
+
E2E.
|
|
16
|
+
- **Evals** score **probabilistic quality**. The same input may produce different output
|
|
17
|
+
each run. The verdict is **graded** (a score, not a boolean), it **samples** the input
|
|
18
|
+
space rather than covering it exhaustively, and it tolerates variance by running many
|
|
19
|
+
times.
|
|
20
|
+
|
|
21
|
+
Rule of thumb: if you can write a deterministic assertion, write a **test**. Reach for an
|
|
22
|
+
**eval** only for the part that is genuinely probabilistic (the model's judgment, phrasing,
|
|
23
|
+
or reasoning).
|
|
24
|
+
|
|
25
|
+
## 2. The Eval Pyramid
|
|
26
|
+
|
|
27
|
+
Like the testing pyramid, push work down to the cheapest, most-deterministic layer that
|
|
28
|
+
can express the check. Climb only when you must.
|
|
29
|
+
|
|
30
|
+
1. **Deterministic assertions (base)** — exact match, regex, JSON-schema validation, set
|
|
31
|
+
membership. Cheap, instant, 100% reproducible. Most "quality" checks are secretly
|
|
32
|
+
deterministic — catch them here.
|
|
33
|
+
2. **Semantic similarity** — embedding cosine similarity against a reference answer, with
|
|
34
|
+
a threshold. Tolerates wording differences while still being mostly reproducible.
|
|
35
|
+
3. **LLM-as-judge** — a model scores the output against a rubric. Expensive, subjective,
|
|
36
|
+
non-deterministic; use for quality dimensions no formula captures (clarity, helpfulness).
|
|
37
|
+
4. **Human review (tip)** — the gold standard and the calibration anchor for everything
|
|
38
|
+
below it. Slowest and most expensive; reserve for high-stakes output and for keeping the
|
|
39
|
+
judges honest.
|
|
40
|
+
|
|
41
|
+
Each layer up costs more and is less reproducible. A good eval suite is fat at the base.
|
|
42
|
+
|
|
43
|
+
## 3. Eval-first, alongside test-first
|
|
44
|
+
|
|
45
|
+
Test-first says: write the failing test before the code. Eval-first extends this to
|
|
46
|
+
probabilistic work: **define the golden dataset and the rubric before building the
|
|
47
|
+
system**. The golden dataset is the executable form of the spec — it states, in concrete
|
|
48
|
+
input/expected pairs, what "good" means. Writing it first forces you to define success
|
|
49
|
+
before you can fool yourself into thinking you have it. See `eval-driven-development.skill`
|
|
50
|
+
for the full workflow (start small, grow the dataset from every real failure).
|
|
51
|
+
|
|
52
|
+
## 4. Where evals plug into GABBE's SDLC
|
|
53
|
+
|
|
54
|
+
- **S05 / S06 (implementation / testing)** — eval **checkpoints**, owned by the **eng-qa**
|
|
55
|
+
persona. As the skill/system is built, it is scored against the golden dataset and rubric
|
|
56
|
+
defined earlier. A failing eval checkpoint blocks the same way a failing test does, once
|
|
57
|
+
the scores are stable enough to gate on (see section 6).
|
|
58
|
+
- **S12 (Day-2 / evolve)** — **continuous eval**. The system runs against the eval suite on
|
|
59
|
+
a schedule so quality drift (model updates, prompt edits, data shift) is caught after
|
|
60
|
+
release, not by users. New production failures become new golden-dataset rows here.
|
|
61
|
+
|
|
62
|
+
The relevant skills slot in by layer: `llm-as-judge.skill` for the Tier-3 judging layer,
|
|
63
|
+
`rag-evaluation.skill` when the system retrieves context (score retrieval and generation
|
|
64
|
+
separately), and `agent-trajectory-eval.skill` when you must grade the *path* an agent took
|
|
65
|
+
(tool calls, intermediate steps), not just its final answer.
|
|
66
|
+
|
|
67
|
+
## 5. Nondeterminism — why we run N times and report pass^k
|
|
68
|
+
|
|
69
|
+
A single run is a single sample from a distribution. Published agent-quality estimates
|
|
70
|
+
vary by roughly **2–6 points** between runs of the *same* system on the *same* tasks, so a
|
|
71
|
+
one-shot number is noise as often as signal. To get a stable read:
|
|
72
|
+
|
|
73
|
+
- Run each case **N times** (e.g., N=5).
|
|
74
|
+
- Report **pass^k** (passes in *all* k runs) for reliability/CI gating — it measures
|
|
75
|
+
consistency, which is what production needs. Report **pass@k** (passes in *at least one*
|
|
76
|
+
of k runs) when you only want to know whether the capability exists at all.
|
|
77
|
+
- Record temperature and seeds so a run can be reproduced.
|
|
78
|
+
|
|
79
|
+
A system that scores 0.95 on pass@5 but 0.55 on pass^5 is not reliable — it can do the task
|
|
80
|
+
but won't do it dependably.
|
|
81
|
+
|
|
82
|
+
## 6. Eval-driven CI — earn the right to block
|
|
83
|
+
|
|
84
|
+
Eval scores are noisy at first, and a flaky gate that fails good PRs trains everyone to
|
|
85
|
+
ignore it. So introduce evals into CI in two stages:
|
|
86
|
+
|
|
87
|
+
1. **Non-blocking nightly first** — run the full suite on a schedule, publish the
|
|
88
|
+
scorecard, watch the variance. Regressions are reported, not enforced.
|
|
89
|
+
2. **Blocking gates only once scores are stable** — promote a check to a PR-blocking gate
|
|
90
|
+
only after it has shown low run-to-run variance. Gate on the deterministic Tier-1/Tier-2
|
|
91
|
+
slice first; keep noisy LLM-judge checks advisory until they calibrate.
|
|
92
|
+
|
|
93
|
+
This mirrors how E2E tests earn their place in CI: prove they are not flaky before you let
|
|
94
|
+
them block the build.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
**Honesty note**: Evals **raise confidence**; they do not **prove** correctness. A green
|
|
99
|
+
scorecard means "no regression detected on the sampled cases", never "correct on all
|
|
100
|
+
inputs" — so keep growing the golden dataset from real failures. And the LLM judge is
|
|
101
|
+
**biased-but-useful**: a fast, scalable proxy that is never ground truth and must be
|
|
102
|
+
**calibrated against human labels**. When you stop calibrating, you stop knowing what your
|
|
103
|
+
scores mean.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# The 2030 Horizon: Future-Proofing Your Stack
|
|
2
|
+
|
|
3
|
+
Software engineering moves fast. In 2026, we are building the foundations for 2030.
|
|
4
|
+
|
|
5
|
+
## 1. The 6G Era: "Internet of Everything" (IoE)
|
|
6
|
+
- **What**: Not just faster phones. 6G connects *surfaces*, *sensors*, and *biological* data.
|
|
7
|
+
- **Speed**: 1 Terabit/s peak. < 1ms latency.
|
|
8
|
+
- **Arch Impact**: The "Cloud" dissolves into a "Continuum". Applications must be **Edge-Native**, dynamically moving compute to where the user is.
|
|
9
|
+
|
|
10
|
+
## 2. Agentic IoT & Matter
|
|
11
|
+
- **Old IoT**: "Dumb" sensors sending JSON to AWS.
|
|
12
|
+
- **New IoT**: AI Agents running on-chip (NPU), talking via **Matter** to other devices locally.
|
|
13
|
+
- **Arch Impact**: Your toaster negotiates energy usage with your solar panel. No cloud involved.
|
|
14
|
+
|
|
15
|
+
## 3. Vector Computing & Semantic Memory
|
|
16
|
+
- **The Shift**: From `SELECT * WHERE name="Bob"` to `SELECT * WHERE meaning="Customer Frustration"`.
|
|
17
|
+
- **The Stack**: Vector Databases (Pinecone, pgvector) are the long-term memory for AI agents.
|
|
18
|
+
- **Arch Impact**: Apps need a "RAG Pipeline" (Retrieval-Augmented Generation) as a core architectural component, alongside the traditional DB.
|
|
19
|
+
|
|
20
|
+
## 4. Local-First & CRDTs
|
|
21
|
+
- **The Problem**: Cloud-dependence makes apps slow and fragile.
|
|
22
|
+
- **The Solution**: Local-First. The app lives on the device. Syncs when possible.
|
|
23
|
+
- **CRDTs**: Mathematical magic that allows two users to edit the same offline document and merge perfectly when online.
|
|
24
|
+
- **Tools**: Automerge, Yjs, ElectricSQL.
|
|
25
|
+
|
|
26
|
+
## 5. WebAssembly (WASM): The Universal Runtime
|
|
27
|
+
- **Promise**: Write in Rust/Go/Typescript, run *anywhere* safely at near-native speed.
|
|
28
|
+
- **Use Case**:
|
|
29
|
+
- **Browser**: Photoshop in the web.
|
|
30
|
+
- **Server**: "Nano-containers" that start in microseconds (faster than Docker).
|
|
31
|
+
- **Plugins**: Allow users to extend your SaaS with untrusted code.
|
|
32
|
+
|
|
33
|
+
## 6. Post-Quantum Cryptography (PQC)
|
|
34
|
+
- **Threat**: Quantum computers (2030+) will break RSA/ECC encryption.
|
|
35
|
+
- **Action**: Start adopting NIST-approved PQC algorithms (CRYSTALS-Kyber) for long-term data storage.
|