@agile-vibe-coding/avc 0.2.3 → 0.3.1

package/cli/checks/epic/devops.json

@@ -0,0 +1,174 @@
+{
+  "perspective": "devops",
+  "scope": "epic",
+  "checks": [
+    {
+      "id": "devops-epic-01",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "critical",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve deployment, infrastructure, or operational concerns? (Does it require CI/CD, containers, or cloud infrastructure?)",
+      "question": "Does the epic scope clearly define deployment and operational boundaries?",
+      "failDescription": "Deployment and operational boundaries are not defined",
+      "failSuggestion": "Define deployment boundaries: what is deployed, where, and how (container, serverless, VM)"
+    },
+    {
+      "id": "devops-epic-02",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "critical",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve deployment, infrastructure, or operational concerns? (Does it require CI/CD, monitoring, or scaling?)",
+      "question": "Are all critical DevOps features identified (CI/CD, monitoring, scaling)?",
+      "failDescription": "Critical DevOps features are missing — CI/CD, monitoring, or scaling not addressed",
+      "failSuggestion": "Identify critical DevOps features: CI/CD pipeline, monitoring/alerting, auto-scaling strategy"
+    },
+    {
+      "id": "devops-epic-03",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "major",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic depend on infrastructure services? (Does it use cloud provider, container registry, or external services?)",
+      "question": "Are dependencies on infrastructure services explicit (cloud provider, container registry)?",
+      "failDescription": "Infrastructure service dependencies are not explicit",
+      "failSuggestion": "Make infrastructure dependencies explicit: cloud provider, container registry, DNS, CDN, load balancer"
+    },
+    {
+      "id": "devops-epic-04",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "major",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic have operational requirements? (Does it need uptime, recovery, or deployment frequency targets?)",
+      "question": "Are operational success criteria measurable (e.g. 99.9% uptime, < 15min MTTR)?",
+      "failDescription": "Operational success criteria are not measurable",
+      "failSuggestion": "Define measurable operational criteria: uptime SLA (e.g. 99.9%), MTTR (e.g. < 15min), deployment frequency"
+    },
+    {
+      "id": "devops-epic-05",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "clarity",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
+      "question": "Is DevOps terminology used correctly and consistently?",
+      "failDescription": "DevOps terminology is used incorrectly or inconsistently",
+      "failSuggestion": "Review and correct DevOps terminology for consistency (e.g. container vs VM, deployment vs release)"
+    },
+    {
+      "id": "devops-epic-06",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "clarity",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
+      "question": "Is the epic description understandable to non-DevOps team members?",
+      "failDescription": "Epic description uses excessive DevOps jargon without explanation",
+      "failSuggestion": "Simplify or explain DevOps concepts so non-DevOps team members can understand the epic"
+    },
+    {
+      "id": "devops-epic-07",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "clarity",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
+      "question": "Are operational features described in terms of business value (faster deployments, reduced downtime)?",
+      "failDescription": "Operational features lack business value context",
+      "failSuggestion": "Frame operational features in business terms: 'automated deployment reduces release time from 2hr to 5min'"
+    },
+    {
+      "id": "devops-epic-08",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "major",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve deploying services? (Does it require containerization, orchestration, or scaling?)",
+      "question": "Is infrastructure architecture considered (containerization, orchestration, scaling)?",
+      "failDescription": "Infrastructure architecture is not considered — containerization, orchestration, or scaling missing",
+      "failSuggestion": "Address infrastructure architecture: containerization (Docker), orchestration (K8s/ECS), scaling strategy"
+    },
+    {
+      "id": "devops-epic-09",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "major",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve deploying to production? (Does it require a deployment strategy?)",
+      "question": "Is a deployment strategy addressed (blue/green, canary, rolling updates)?",
+      "failDescription": "Deployment strategy is not addressed",
+      "failSuggestion": "Define deployment strategy: blue/green, canary, or rolling updates with rollback plan"
+    },
+    {
+      "id": "devops-epic-10",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "major",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve running production services? (Does it require logging, metrics, or tracing?)",
+      "question": "Is an observability stack defined (metrics, logs, traces)?",
+      "failDescription": "Observability stack is not defined — no metrics, logging, or tracing specified",
+      "failSuggestion": "Define observability stack: logging (ELK, CloudWatch), metrics (Prometheus, Datadog), tracing (X-Ray, Jaeger)"
+    },
+    {
+      "id": "devops-epic-11",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve production data or services? (Does it require backup or disaster recovery?)",
+      "question": "Is a disaster recovery and backup strategy mentioned?",
+      "failDescription": "Disaster recovery and backup strategy is not mentioned",
+      "failSuggestion": "Mention disaster recovery: backup frequency, RTO/RPO targets, recovery procedures"
+    },
+    {
+      "id": "devops-epic-12",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "consistency",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
+      "question": "Does the DevOps approach align with the project context and cloud platform?",
+      "failDescription": "DevOps approach does not align with project context or cloud platform",
+      "failSuggestion": "Align DevOps approach with project context: ensure tools and patterns match the chosen cloud platform"
+    },
+    {
+      "id": "devops-epic-13",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "best-practices",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
+      "question": "Are industry-standard DevOps patterns followed (12-factor app, GitOps, immutable infrastructure)?",
+      "failDescription": "Industry-standard DevOps patterns are not followed",
+      "failSuggestion": "Follow DevOps best practices: 12-factor app principles, GitOps workflows, immutable infrastructure"
+    },
+    {
+      "id": "devops-epic-14",
+      "tier": 1,
+      "perspective": "devops",
+      "severity": "minor",
+      "category": "best-practices",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve DevOps infrastructure or operational concerns?",
+      "question": "Does the epic avoid DevOps anti-patterns (manual deployments, configuration drift, snowflake servers)?",
+      "failDescription": "Epic may introduce DevOps anti-patterns — manual deployments, configuration drift, or snowflake servers",
+      "failSuggestion": "Avoid DevOps anti-patterns: automate deployments, manage config as code, use immutable infrastructure"
+    }
+  ]
+}

package/cli/checks/epic/frontend.json

@@ -0,0 +1,162 @@
+{
+  "perspective": "frontend",
+  "scope": "epic",
+  "checks": [
+    {
+      "id": "fe-epic-01",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "critical",
+      "category": "ui-architecture-specification",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve a user-facing web interface? (Does it include UI components, pages, or client-side rendering?)",
+      "question": "Does the epic state the frontend framework (React, Vue, Angular, etc.)?",
+      "failDescription": "Frontend framework is not stated — foundational technology decision is missing",
+      "failSuggestion": "State the frontend framework: React, Vue, Angular, Svelte, etc."
+    },
+    {
+      "id": "fe-epic-02",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "critical",
+      "category": "ui-architecture-specification",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve fetching data from a server? (Does it make API calls or query a backend?)",
+      "question": "Does the epic name the server-state management library (TanStack Query, SWR, Apollo) and describe its usage pattern?",
+      "failDescription": "Server-state management library is not named or its usage pattern is not described",
+      "failSuggestion": "Name the server-state management library (TanStack Query, SWR, Apollo) and describe caching/refetch patterns"
+    },
+    {
+      "id": "fe-epic-03",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "major",
+      "category": "ui-architecture-specification",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve client-side state beyond server data? (Does it need UI state, form state, or application state?)",
+      "question": "Does the epic name the client-state management strategy (Zustand, Redux, Context) — or explicitly state 'no client state beyond React Query cache'?",
+      "failDescription": "Client-state management strategy is not named or explicitly declared absent",
+      "failSuggestion": "Name the client-state strategy (Zustand, Redux, Context) or explicitly state 'no client state beyond server-state cache'"
+    },
+    {
+      "id": "fe-epic-04",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "major",
+      "category": "ui-architecture-specification",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve a user-facing web interface? (Does it include UI components?)",
+      "question": "Does the epic name the key UI component types (table, form, modal, drawer, chart, etc.)?",
+      "failDescription": "Key UI component types are not named",
+      "failSuggestion": "Name the key UI component types: tables, forms, modals, drawers, charts, etc."
+    },
+    {
+      "id": "fe-epic-05",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "critical",
+      "category": "async-error-ux-strategy",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve asynchronous operations? (Does it fetch data, submit forms, or call APIs?)",
+      "question": "Does the epic name a loading state strategy (skeleton loaders, spinners, progressive enhancement)?",
+      "failDescription": "Loading state strategy is not named — users will see undefined behavior during async operations",
+      "failSuggestion": "Name the loading state strategy: skeleton loaders, spinners, disabled buttons, or progressive enhancement"
+    },
+    {
+      "id": "fe-epic-06",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "critical",
+      "category": "async-error-ux-strategy",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve asynchronous operations? (Does it fetch data, submit forms, or call APIs?)",
+      "question": "Does the epic name an error state strategy (toast notifications, inline errors, error boundaries)?",
+      "failDescription": "Error state strategy is not named — errors will not be communicated to users",
+      "failSuggestion": "Name the error state strategy: toast notifications, inline errors, error boundaries, or retry prompts"
+    },
+    {
+      "id": "fe-epic-07",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "major",
+      "category": "async-error-ux-strategy",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve lists or search views? (Does it display collections of items or search results?)",
+      "question": "Does the epic describe empty state handling for all list/search views?",
+      "failDescription": "Empty state handling is not described for list/search views",
+      "failSuggestion": "Describe empty state handling: what renders when data is empty (illustration, message, call-to-action)"
+    },
+    {
+      "id": "fe-epic-08",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "minor",
+      "category": "async-error-ux-strategy",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve data mutations? (Does it create, update, or delete data?)",
+      "question": "Does the epic state an optimistic update strategy for mutation-heavy features?",
+      "failDescription": "Optimistic update strategy is not stated for mutation-heavy features",
+      "failSuggestion": "State whether mutations use optimistic updates (immediate UI update, rollback on failure) or wait for server confirmation"
+    },
+    {
+      "id": "fe-epic-09",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "major",
+      "category": "accessibility-standards",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve a user-facing web interface? (Does it render UI for end users?)",
+      "question": "Does the epic state an accessibility standard (WCAG 2.1 AA or equivalent) if user-facing?",
+      "failDescription": "Accessibility standard is not stated for user-facing interface",
+      "failSuggestion": "State the accessibility standard: WCAG 2.1 AA, Section 508, or equivalent"
+    },
+    {
+      "id": "fe-epic-10",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "minor",
+      "category": "accessibility-standards",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve interactive UI components? (Does it have forms, modals, menus, or dropdowns?)",
+      "question": "Does the epic require keyboard navigation for interactive components?",
+      "failDescription": "Keyboard navigation requirement is not stated for interactive components",
+      "failSuggestion": "Require keyboard navigation for interactive components: Tab, Enter, Escape, Arrow keys for forms, modals, menus"
+    },
+    {
+      "id": "fe-epic-11",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "minor",
+      "category": "accessibility-standards",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve dynamic content updates? (Does it have live feeds, notifications, or async-loaded content?)",
+      "question": "Does the epic describe an ARIA strategy for dynamic content (live regions, labeled controls)?",
+      "failDescription": "ARIA strategy for dynamic content is not described",
+      "failSuggestion": "Describe ARIA strategy: aria-live regions for async updates, aria-label for controls, aria-describedby for errors"
+    },
+    {
+      "id": "fe-epic-12",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "minor",
+      "category": "performance-build",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve a web application with multiple routes or heavy components? (Does it have route-based views or large libraries?)",
+      "question": "Does the epic describe a code splitting strategy (route-level, component-level) if relevant?",
+      "failDescription": "Code splitting strategy is not described",
+      "failSuggestion": "Describe code splitting: route-level lazy loading, component-level splitting for heavy libraries"
+    },
+    {
+      "id": "fe-epic-13",
+      "tier": 1,
+      "perspective": "frontend",
+      "severity": "minor",
+      "category": "performance-build",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve a user-facing web application? (Does it need to load quickly for end users?)",
+      "question": "Does the epic specify performance targets (bundle size, LCP, FID, CLS) — or 'N/A for internal tool'?",
+      "failDescription": "Performance targets are not specified",
+      "failSuggestion": "Specify performance targets: bundle size budget, LCP < 2.5s, FID < 100ms, CLS < 0.1 — or state 'N/A for internal tool'"
+    }
+  ]
+}

package/cli/checks/epic/mobile.json

@@ -0,0 +1,102 @@
+{
+  "perspective": "mobile",
+  "scope": "epic",
+  "checks": [
+    {
+      "id": "mob-epic-01",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "critical",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile application development? (Does it target iOS, Android, React Native, or Flutter?)",
+      "question": "Does the epic scope clearly define mobile boundaries?",
+      "failDescription": "Mobile boundaries are not defined — unclear which platforms and features are in scope",
+      "failSuggestion": "Define mobile boundaries: target platforms (iOS, Android), minimum OS versions, device support"
+    },
+    {
+      "id": "mob-epic-02",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "critical",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile application development?",
+      "question": "Are all critical mobile features identified?",
+      "failDescription": "Critical mobile features are missing — platform support, offline mode, or push notifications not identified",
+      "failSuggestion": "Identify critical mobile features: platform support, offline capability, push notifications, deep linking"
+    },
+    {
+      "id": "mob-epic-03",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "major",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic depend on mobile services or infrastructure?",
+      "question": "Are dependencies on mobile services/infrastructure explicit?",
+      "failDescription": "Mobile service dependencies are not explicit",
+      "failSuggestion": "Make mobile dependencies explicit: push notification service, app store accounts, analytics SDK, crash reporting"
+    },
+    {
+      "id": "mob-epic-04",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "major",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile application development?",
+      "question": "Are mobile success criteria measurable?",
+      "failDescription": "Mobile success criteria are not measurable",
+      "failSuggestion": "Define measurable mobile criteria: app startup time, crash rate, battery usage, app store rating target"
+    },
+    {
+      "id": "mob-epic-05",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "major",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile architecture?",
+      "question": "Are mobile architectural patterns considered?",
+      "failDescription": "Mobile architectural patterns are not considered",
+      "failSuggestion": "Consider mobile patterns: MVVM/MVP, offline-first, data synchronization, navigation patterns"
+    },
+    {
+      "id": "mob-epic-06",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "major",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile apps that need to perform well?",
+      "question": "Are performance/scalability concerns for mobile addressed?",
+      "failDescription": "Mobile performance concerns are not addressed",
+      "failSuggestion": "Address mobile performance: battery optimization, memory management, network efficiency, image caching"
+    },
+    {
+      "id": "mob-epic-07",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "minor",
+      "category": "consistency",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile application development?",
+      "question": "Does the mobile approach align with project context?",
+      "failDescription": "Mobile approach does not align with project context",
+      "failSuggestion": "Ensure mobile approach aligns with project: consistent platform strategy, UI patterns, navigation conventions"
+    },
+    {
+      "id": "mob-epic-08",
+      "tier": 1,
+      "perspective": "mobile",
+      "severity": "minor",
+      "category": "best-practices",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve mobile application development?",
+      "question": "Are industry-standard mobile patterns followed (native patterns, offline-first)?",
+      "failDescription": "Mobile best practices are not followed",
+      "failSuggestion": "Follow mobile best practices: platform-native patterns, offline-first design, responsive layouts, gesture support"
+    }
+  ]
+}

package/cli/checks/epic/qa.json

@@ -0,0 +1,90 @@
+{
+  "perspective": "qa",
+  "scope": "epic",
+  "checks": [
+    {
+      "id": "qa-epic-01",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "critical",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve testing, quality assurance, or quality gates? (Does it define testing strategy, quality metrics, or test automation?)",
+      "question": "Does the epic scope clearly define QA boundaries?",
+      "failDescription": "QA boundaries are not defined — unclear which test levels and quality gates are in scope",
+      "failSuggestion": "Define QA boundaries: which test levels (unit, integration, e2e), quality gates, and acceptance criteria are in scope"
+    },
+    {
+      "id": "qa-epic-02",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "critical",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve testing, quality assurance, or quality gates?",
+      "question": "Are all critical QA features identified?",
+      "failDescription": "Critical QA features are missing — test strategy, coverage targets, or quality metrics not identified",
+      "failSuggestion": "Identify critical QA features: test strategy, coverage targets, defect management process, quality metrics"
+    },
+    {
+      "id": "qa-epic-03",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "major",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic depend on QA services or infrastructure?",
+      "question": "Are dependencies on QA services/infrastructure explicit?",
+      "failDescription": "QA dependencies are not explicit",
+      "failSuggestion": "Make QA dependencies explicit: test frameworks, CI/CD integration, test environments, test data management"
+    },
+    {
+      "id": "qa-epic-04",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "major",
+      "category": "completeness",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve testing, quality assurance, or quality gates?",
+      "question": "Are QA success criteria measurable?",
+      "failDescription": "QA success criteria are not measurable",
+      "failSuggestion": "Define measurable QA criteria: test coverage (>80%), defect escape rate, test execution time, pass rate"
+    },
+    {
+      "id": "qa-epic-05",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "major",
+      "category": "technical-depth",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve QA architecture or test strategy?",
+      "question": "Are QA architectural patterns considered?",
+      "failDescription": "QA patterns are not considered — test pyramid, automation strategy, or test data management missing",
+      "failSuggestion": "Consider QA patterns: test pyramid, automation vs manual balance, test data management, environment strategy"
+    },
+    {
+      "id": "qa-epic-06",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "minor",
+      "category": "consistency",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve testing, quality assurance, or quality gates?",
+      "question": "Does the QA approach align with project context?",
+      "failDescription": "QA approach does not align with project context",
+      "failSuggestion": "Ensure QA approach aligns with project: consistent test frameworks, naming conventions, reporting"
+    },
+    {
+      "id": "qa-epic-07",
+      "tier": 1,
+      "perspective": "qa",
+      "severity": "minor",
+      "category": "best-practices",
+      "universal": false,
+      "applicabilityQuestion": "Does this epic involve testing, quality assurance, or quality gates?",
+      "question": "Are industry-standard QA patterns followed (test pyramid, shift-left)?",
+      "failDescription": "QA best practices are not followed",
+      "failSuggestion": "Follow QA best practices: test pyramid, shift-left testing, continuous testing, BDD/TDD where appropriate"
+    }
+  ]
+}