{
  "categories": [
    {
      "name": "Component Tags",
      "description": "Tags that identify which architectural component a feature belongs to.",
      "required": true,
      "tags": [
        {
          "name": "@agent-registry",
          "description": "Agent registry and configuration management"
        },
        {
          "name": "@algorithm",
          "description": "Algorithmic components - similarity matching, scoring, deduplication algorithms"
        },
        {
          "name": "@cli",
          "description": "Command-Line Interface"
        },
        {
          "name": "@demos",
          "description": "Demo script functionality and video recording infrastructure"
        },
        {
          "name": "@dialog",
          "description": "Dialog and modal UI components in TUI"
        },
        {
          "name": "@file-ops",
          "description": "File Operations"
        },
        {
          "name": "@formatter",
          "description": "Formatting & Prettification"
        },
        {
          "name": "@generator",
          "description": "Template Generation"
        },
        {
          "name": "@git",
          "description": "Git operations and version control integration"
        },
        {
          "name": "@git-integration",
          "description": "Git integration and version control features"
        },
        {
          "name": "@git-ops",
          "description": "Git operations and version control features"
        },
        {
          "name": "@hooks",
          "description": "Hooks system and execution engine"
        },
        {
          "name": "@init",
          "description": "Initialization and setup features"
        },
        {
          "name": "@integration",
          "description": "Cross-Component Integration"
        },
        {
          "name": "@npm",
          "description": "npm package management and dependency resolution"
        },
        {
          "name": "@parser",
          "description": "Gherkin Parser Integration"
        },
        {
          "name": "@templates",
          "description": "Template generation and transformation system"
        },
        {
          "name": "@tui",
          "description": "Terminal User Interface components and infrastructure"
        },
        {
          "name": "@tui-component",
          "description": "Terminal User Interface components"
        },
        {
          "name": "@ui",
          "description": "User interface and visual components"
        },
        {
          "name": "@utils",
          "description": "Utility functions and helpers"
        },
        {
          "name": "@validator",
          "description": "Validation Logic"
        },
        {
          "name": "@viewer",
          "description": "Attachment viewer component (web-based mermaid/markdown renderer)"
        },
        {
          "name": "@virtuallist",
          "description": "Features related to VirtualList component"
        }
      ],
      "rule": "Every feature file MUST have at least ONE component tag (may have multiple if cross-component)."
    },
    {
      "name": "Feature Group Tags",
      "description": "Tags that categorize features by functional area.",
      "required": true,
      "tags": [
        {
          "name": "@accuracy",
          "description": "Accuracy measurement"
        },
        {
          "name": "@agent-compatibility",
          "description": "Features ensuring correct behavior across all 18 supported AI agents"
        },
        {
          "name": "@agent-detection",
          "description": "Agent detection and runtime configuration features"
        },
        {
          "name": "@agent-integration",
          "description": "Features related to AI agent initialization, detection, and integration"
        },
        {
          "name": "@agent-support",
          "description": "Multi-agent support and agent-specific configurations"
        },
        {
          "name": "@ai-assistance",
          "description": "AI-assisted features for analysis and extraction"
        },
        {
          "name": "@answer-question",
          "description": "Question answering operations"
        },
        {
          "name": "@assumption-management",
          "description": "Assumption tracking in Example Mapping"
        },
        {
          "name": "@attachment",
          "description": "File attachment management features"
        },
        {
          "name": "@attachment-management",
          "description": "Attachment management features for work units"
        },
        {
          "name": "@attachment-viewer",
          "description": "Features related to viewing and rendering work unit attachments"
        },
        {
          "name": "@attachments",
          "description": "Feature related to work unit attachments (diagrams, documents, mockups)"
        },
        {
          "name": "@authentication",
          "description": "Authentication and authorization functionality"
        },
        {
          "name": "@auto-blocking",
          "description": "Automatic blocking state transitions"
        },
        {
          "name": "@auto-transition",
          "description": "Automatic state transitions"
        },
        {
          "name": "@blocked-state",
          "description": "Blocked state handling"
        },
        {
          "name": "@board",
          "description": "Kanban board operations"
        },
        {
          "name": "@board-view",
          "description": "Kanban board visualization"
        },
        {
          "name": "@board-visualization",
          "description": "Kanban board visualization and layout features"
        },
        {
          "name": "@bootstrap",
          "description": "Bootstrap documentation and initialization workflows"
        },
        {
          "name": "@bug-reporting",
          "description": "Bug reporting and issue submission features"
        },
        {
          "name": "@bulk",
          "description": "Bulk operations"
        },
        {
          "name": "@bulk-add",
          "description": "Bulk add operations"
        },
        {
          "name": "@bulk-export",
          "description": "Bulk export operations"
        },
        {
          "name": "@bulk-operations",
          "description": "Bulk Multi-File Operations"
        },
        {
          "name": "@burndown",
          "description": "Burndown chart generation"
        },
        {
          "name": "@by-prefix",
          "description": "Querying or filtering work units by prefix (e.g., AUTH-, DASH-)"
        },
        {
          "name": "@calculation",
          "description": "Calculation operations"
        },
        {
          "name": "@cascade",
          "description": "Cascade operations"
        },
        {
          "name": "@checkpoint",
          "description": "Checkpoint and snapshot management for experimentation and recovery"
        },
        {
          "name": "@checkpoint-management",
          "description": "Checkpoint creation, restoration, and management functionality"
        },
        {
          "name": "@code-analysis",
          "description": "Code analysis and AST research features"
        },
        {
          "name": "@code-quality",
          "description": "Code quality validation and review features"
        },
        {
          "name": "@comparison",
          "description": "Comparison operations"
        },
        {
          "name": "@completion",
          "description": "Completion operations"
        },
        {
          "name": "@compound",
          "description": "Compound query operations"
        },
        {
          "name": "@config-management",
          "description": "Configuration management and settings features"
        },
        {
          "name": "@configuration",
          "description": "Configuration loading and validation"
        },
        {
          "name": "@coverage",
          "description": "Coverage tracking and traceability features"
        },
        {
          "name": "@coverage-tracking",
          "description": "Coverage tracking and traceability from scenarios to tests to implementation code"
        },
        {
          "name": "@critical-path",
          "description": "Critical path analysis"
        },
        {
          "name": "@crud",
          "description": "Create, Read, Update, Delete operations"
        },
        {
          "name": "@delete",
          "description": "Delete operations"
        },
        {
          "name": "@dependencies",
          "description": "Dependency management between work units"
        },
        {
          "name": "@dependency-management",
          "description": "Work unit dependency tracking"
        },
        {
          "name": "@diagram",
          "description": "Features related to diagram management and visualization"
        },
        {
          "name": "@diagram-viewer",
          "description": "Diagram viewing and fullscreen modal features"
        },
        {
          "name": "@diff-display",
          "description": "Diff display and visualization features in TUI"
        },
        {
          "name": "@diff-viewer",
          "description": "Diff visualization and comparison features"
        },
        {
          "name": "@discovery-command",
          "description": "Example Mapping discovery commands"
        },
        {
          "name": "@documentation",
          "description": "Documentation Display"
        },
        {
          "name": "@documentation-management",
          "description": "Documentation generation, updates, and maintenance"
        },
        {
          "name": "@epics",
          "description": "Epic management and high-level work grouping"
        },
        {
          "name": "@estimation",
          "description": "Estimation operations"
        },
        {
          "name": "@event-storm",
          "description": "Event Storming functionality for domain modeling"
        },
        {
          "name": "@event-storming",
          "description": "Event Storming discovery and domain modeling features"
        },
        {
          "name": "@example-mapping",
          "description": "Example mapping for BDD discovery (rules, examples, questions, assumptions)"
        },
        {
          "name": "@export",
          "description": "Export operations"
        },
        {
          "name": "@feature-management",
          "description": "Feature File Operations"
        },
        {
          "name": "@filtering",
          "description": "Filtering and query operations"
        },
        {
          "name": "@forecasting",
          "description": "Forecasting and predictions"
        },
        {
          "name": "@formatting",
          "description": "Auto-Formatting"
        },
        {
          "name": "@foundation",
          "description": "Foundation documentation and schema features"
        },
        {
          "name": "@foundation-management",
          "description": "FOUNDATION.md Operations"
        },
        {
          "name": "@generate-scenarios",
          "description": "Scenario generation from examples"
        },
        {
          "name": "@help-system",
          "description": "Help system and documentation features"
        },
        {
          "name": "@help-text",
          "description": "Help and documentation features"
        },
        {
          "name": "@hook-execution",
          "description": "Hook execution and lifecycle management"
        },
        {
          "name": "@impact-analysis",
          "description": "Impact analysis and dependency chains"
        },
        {
          "name": "@infrastructure",
          "description": "Core infrastructure and shared utilities"
        },
        {
          "name": "@interaction",
          "description": "User interaction and input handling features"
        },
        {
          "name": "@interactive-cli",
          "description": "Interactive CLI features and TUI workflows"
        },
        {
          "name": "@kanban",
          "description": "Kanban board and workflow management"
        },
        {
          "name": "@language-support",
          "description": "Programming language support and integration"
        },
        {
          "name": "@list",
          "description": "List operations"
        },
        {
          "name": "@metrics",
          "description": "Metrics and measurements"
        },
        {
          "name": "@metrics-estimation",
          "description": "Metrics and estimation tracking"
        },
        {
          "name": "@migration",
          "description": "Migration & Data Transformation"
        },
        {
          "name": "@modification",
          "description": "Feature Modification Operations"
        },
        {
          "name": "@multi-agent-support",
          "description": "Features related to supporting multiple AI coding agents beyond Claude"
        },
        {
          "name": "@navigation",
          "description": "Navigation and keyboard interaction features in the TUI"
        },
        {
          "name": "@operations",
          "description": "General operations"
        },
        {
          "name": "@orchestration",
          "description": "Command orchestration features that coordinate multiple operations"
        },
        {
          "name": "@parent-child",
          "description": "Parent-child work unit relationships"
        },
        {
          "name": "@prediction",
          "description": "Prediction operations"
        },
        {
          "name": "@prefix-epic",
          "description": "Prefix and epic management"
        },
        {
          "name": "@prefixes",
          "description": "Work unit ID prefix management"
        },
        {
          "name": "@priority",
          "description": "Priority management and reordering"
        },
        {
          "name": "@progress",
          "description": "Progress tracking and reporting"
        },
        {
          "name": "@project-management",
          "description": "Project management features including work units, epics, and workflow"
        },
        {
          "name": "@quality-assurance",
          "description": "Quality assurance and code review features"
        },
        {
          "name": "@query",
          "description": "Query operations for searching and filtering"
        },
        {
          "name": "@query-reporting",
          "description": "Query and reporting features"
        },
        {
          "name": "@querying",
          "description": "Query & Search Operations"
        },
        {
          "name": "@read",
          "description": "Read operations"
        },
        {
          "name": "@read-only",
          "description": "Read-Only Operations"
        },
        {
          "name": "@recommendations",
          "description": "Recommendation features providing suggestions based on historical data"
        },
        {
          "name": "@release-management",
          "description": "Release and version management features"
        },
        {
          "name": "@remove",
          "description": "Remove operations"
        },
        {
          "name": "@repair",
          "description": "Data repair operations"
        },
        {
          "name": "@report-bug",
          "description": "Features related to reporting bugs to GitHub"
        },
        {
          "name": "@reporting",
          "description": "Reporting and statistics"
        },
        {
          "name": "@research",
          "description": "Research and discovery tools"
        },
        {
          "name": "@research-integration",
          "description": "Research tool integration and plugin system features"
        },
        {
          "name": "@research-tools",
          "description": "Research tool system features and integrations"
        },
        {
          "name": "@reverse-acdd",
          "description": "Features related to reverse ACDD for documenting existing codebases"
        },
        {
          "name": "@safety",
          "description": "Safety and security features preventing accidental operations"
        },
        {
          "name": "@scaffolding",
          "description": "Project Setup & Templates"
        },
        {
          "name": "@scalability",
          "description": "Scalability and performance optimization features"
        },
        {
          "name": "@scenario-deduplication",
          "description": "Scenario deduplication and refactoring detection features"
        },
        {
          "name": "@scenario-generation",
          "description": "Features related to generating scenarios from example mapping"
        },
        {
          "name": "@schema-design",
          "description": "Schema design and data structure definition"
        },
        {
          "name": "@security",
          "description": "Security-related features and bug fixes"
        },
        {
          "name": "@soft-dependency",
          "description": "Soft dependency relationships"
        },
        {
          "name": "@state-enforcement",
          "description": "State transition enforcement"
        },
        {
          "name": "@state-history",
          "description": "State history tracking"
        },
        {
          "name": "@state-management",
          "description": "Work unit state management and transitions"
        },
        {
          "name": "@state-transition",
          "description": "State transition operations"
        },
        {
          "name": "@statistics",
          "description": "Statistical analysis"
        },
        {
          "name": "@strategy-detection",
          "description": "Strategy detection and selection for reverse ACDD workflows"
        },
        {
          "name": "@system-reminders",
          "description": "System reminder and anti-drift pattern features"
        },
        {
          "name": "@tag-management",
          "description": "TAGS.md Operations"
        },
        {
          "name": "@test-coverage",
          "description": "Test coverage tracking and validation features"
        },
        {
          "name": "@test-maintenance",
          "description": "Test maintenance and quality assurance features"
        },
        {
          "name": "@testing",
          "description": "Testing and quality assurance features"
        },
        {
          "name": "@tool-discovery",
          "description": "Tool discovery and listing features"
        },
        {
          "name": "@tracking",
          "description": "Metric tracking operations"
        },
        {
          "name": "@ui-enhancement",
          "description": "TUI user interface enhancements and visual improvements"
        },
        {
          "name": "@ui-refinement",
          "description": "UI refinement and enhancement operations"
        },
        {
          "name": "@update",
          "description": "Update operations"
        },
        {
          "name": "@utility",
          "description": "Utility & Helper Commands"
        },
        {
          "name": "@validation",
          "description": "Syntax & Structure Validation"
        },
        {
          "name": "@velocity",
          "description": "Velocity calculation"
        },
        {
          "name": "@version-management",
          "description": "Features related to version checking, upgrading, and file synchronization"
        },
        {
          "name": "@video-recording",
          "description": "Video recording and demo playback features"
        },
        {
          "name": "@visual-design",
          "description": "Visual design and branding features"
        },
        {
          "name": "@visualization",
          "description": "Data visualization"
        },
        {
          "name": "@work-management",
          "description": "Work unit management and Kanban workflow operations"
        },
        {
          "name": "@work-unit-linking",
          "description": "Scenarios related to work unit and feature file linking functionality"
        },
        {
          "name": "@work-unit-management",
          "description": "Work unit lifecycle and status management"
        },
        {
          "name": "@work-units",
          "description": "Work unit CRUD operations"
        },
        {
          "name": "@workflow",
          "description": "Workflow and state transition features"
        },
        {
          "name": "@workflow-automation",
          "description": "Workflow automation and lifecycle integration utilities"
        },
        {
          "name": "@workflow-command",
          "description": "ACDD workflow-related commands"
        }
      ],
      "rule": "Every feature file MUST have at least ONE feature group tag."
    },
    {
      "name": "Technical Tags",
      "description": "Tags for specific technical concerns or architectural patterns.",
      "required": false,
      "tags": [
        {
          "name": "@ai-assisted",
          "description": "Features using AI-driven analysis and interaction"
        },
        {
          "name": "@ai-driven",
          "description": "AI-driven interactive and conversational commands"
        },
        {
          "name": "@ai-guidance",
          "description": "Features that provide contextual guidance to AI agents"
        },
        {
          "name": "@anti-drift",
          "description": "Features that prevent AI drift and maintain workflow discipline"
        },
        {
          "name": "@ast",
          "description": "Abstract Syntax Tree"
        },
        {
          "name": "@ast-analysis",
          "description": "AST-based code analysis features"
        },
        {
          "name": "@auth-001",
          "description": "Work unit identifier for authentication features (example in example-mapping feature)"
        },
        {
          "name": "@auto-create",
          "description": "Scenarios testing automatic file creation when files are missing"
        },
        {
          "name": "@automation",
          "description": "Automated workflow operations and state transitions"
        },
        {
          "name": "@backward-compatibility",
          "description": "Features ensuring compatibility with older file formats or legacy systems"
        },
        {
          "name": "@bdd",
          "description": "Behavior-Driven Development methodology"
        },
        {
          "name": "@browser-integration",
          "description": "Features requiring browser launcher integration"
        },
        {
          "name": "@build",
          "description": "Build system configuration and bundling"
        },
        {
          "name": "@bundling",
          "description": "Features related to build bundling and module resolution"
        },
        {
          "name": "@checkpoints",
          "description": "Git checkpoint and state restoration features"
        },
        {
          "name": "@cleanup",
          "description": "Cleanup and resource management features"
        },
        {
          "name": "@code-review",
          "description": "Code review and quality analysis features"
        },
        {
          "name": "@codex",
          "description": "Codex AI agent integration features"
        },
        {
          "name": "@command-registration",
          "description": "CLI command registration features"
        },
        {
          "name": "@concurrency",
          "description": "Concurrent access coordination and file locking mechanisms"
        },
        {
          "name": "@config",
          "description": "Configuration loading and management features"
        },
        {
          "name": "@cucumber-parser",
          "description": "Cucumber Parser Integration"
        },
        {
          "name": "@cucumber-style",
          "description": "Cucumber-style step definition and matching patterns"
        },
        {
          "name": "@dart",
          "description": "Dart language and Flutter framework features"
        },
        {
          "name": "@data-integrity",
          "description": "Data integrity validation and consistency checks"
        },
        {
          "name": "@data-model",
          "description": "Features related to data models, schemas, and data structure transformations"
        },
        {
          "name": "@ddd",
          "description": "Domain-Driven Design concepts, Event Storming, bounded contexts, aggregates"
        },
        {
          "name": "@destructive-action",
          "description": "Features requiring confirmation dialogs for destructive operations (delete, overwrite, etc.)"
        },
        {
          "name": "@development-tools",
          "description": "Development tooling and utilities"
        },
        {
          "name": "@discovery",
          "description": "BDD discovery technique used before writing Gherkin scenarios"
        },
        {
          "name": "@email",
          "description": "Email-related functionality"
        },
        {
          "name": "@error-handling",
          "description": "Error Handling"
        },
        {
          "name": "@eslint",
          "description": "ESLint configuration and linting"
        },
        {
          "name": "@file-discovery",
          "description": "File discovery and pattern matching functionality"
        },
        {
          "name": "@file-initialization",
          "description": "Scenarios testing initialization of project files"
        },
        {
          "name": "@file-structure",
          "description": "File and directory structure validation"
        },
        {
          "name": "@file-system",
          "description": "File System Operations"
        },
        {
          "name": "@file-watcher",
          "description": "File system watching and monitoring features"
        },
        {
          "name": "@file-watching",
          "description": "Features using file system watchers (fs.watch) for change detection"
        },
        {
          "name": "@flexbox",
          "description": "Flexbox layout implementation and responsive design"
        },
        {
          "name": "@format-check",
          "description": "Format and style checking"
        },
        {
          "name": "@fullscreen",
          "description": "Fullscreen modal and overlay features"
        },
        {
          "name": "@function-signature",
          "description": "Function signature validation and checking"
        },
        {
          "name": "@gherkin",
          "description": "Gherkin Specification Compliance"
        },
        {
          "name": "@github-integration",
          "description": "Features integrating with GitHub API or URLs"
        },
        {
          "name": "@graceful-degradation",
          "description": "Features that gracefully handle missing or invalid data"
        },
        {
          "name": "@guidance",
          "description": "Features that provide AI guidance/prompts rather than code implementation"
        },
        {
          "name": "@http-server",
          "description": "HTTP server implementation and lifecycle management"
        },
        {
          "name": "@idempotent",
          "description": "Operations that can be safely repeated without changing results"
        },
        {
          "name": "@initialization",
          "description": "File and system initialization features"
        },
        {
          "name": "@ink",
          "description": "Ink (React for CLIs) rendering engine"
        },
        {
          "name": "@interactive",
          "description": "Interactive terminal UI features using Ink"
        },
        {
          "name": "@internal",
          "description": "Internal Utility"
        },
        {
          "name": "@investigation",
          "description": "Investigation and research tasks for evaluating technical approaches"
        },
        {
          "name": "@ipc",
          "description": "Inter-process communication features using Unix sockets or named pipes"
        },
        {
          "name": "@isomorphic-git",
          "description": "Uses isomorphic-git library for pure JavaScript git operations"
        },
        {
          "name": "@jira",
          "description": "JIRA integration and API features"
        },
        {
          "name": "@json-backed",
          "description": "JSON-Backed Documentation"
        },
        {
          "name": "@json-output",
          "description": "JSON format output support"
        },
        {
          "name": "@json-schema",
          "description": "JSON Schema Validation"
        },
        {
          "name": "@keyboard-navigation",
          "description": "Keyboard input and navigation features"
        },
        {
          "name": "@kotlin",
          "description": "Kotlin language and JVM features"
        },
        {
          "name": "@layout",
          "description": "Layout and visual presentation features"
        },
        {
          "name": "@learning",
          "description": "Machine learning and adaptive features based on usage patterns"
        },
        {
          "name": "@logging",
          "description": "Logging and diagnostics features"
        },
        {
          "name": "@markdown",
          "description": "Markdown rendering and processing"
        },
        {
          "name": "@markdown-formatting",
          "description": "Markdown formatting and rendering features"
        },
        {
          "name": "@marked",
          "description": "Marked library for markdown parsing"
        },
        {
          "name": "@mermaid",
          "description": "Mermaid Diagram Support"
        },
        {
          "name": "@modal",
          "description": "Modal overlay and dialog components"
        },
        {
          "name": "@mouse-events",
          "description": "Features that handle mouse and trackpad events"
        },
        {
          "name": "@multi-agent",
          "description": "Multi-agent compatibility features and agent-specific customizations"
        },
        {
          "name": "@outside-in-bdd",
          "description": "Outside-in BDD approach using personas and behavior-first thinking"
        },
        {
          "name": "@pattern-detection",
          "description": "Features involving pattern detection and analysis from historical data"
        },
        {
          "name": "@performance",
          "description": "Performance optimization and efficiency features"
        },
        {
          "name": "@platform-agnostic",
          "description": "Features supporting multiple platforms (Python, Rust, Go, JavaScript, etc.)"
        },
        {
          "name": "@plugin-system",
          "description": "Plugin architecture and dynamic module loading"
        },
        {
          "name": "@prettier",
          "description": "Prettier configuration and code formatting"
        },
        {
          "name": "@push",
          "description": "Push notification functionality"
        },
        {
          "name": "@query-api",
          "description": "Tree-sitter Query API features using S-expression pattern matching"
        },
        {
          "name": "@react",
          "description": "React framework and component lifecycle features"
        },
        {
          "name": "@real-time",
          "description": "Features with real-time data synchronization and live updates"
        },
        {
          "name": "@resilience",
          "description": "Error handling and graceful degradation features"
        },
        {
          "name": "@responsive",
          "description": "Components that respond to viewport or terminal dimension changes"
        },
        {
          "name": "@reverse-engineering",
          "description": "Reverse engineering existing code to create specifications"
        },
        {
          "name": "@review",
          "description": "Code review and quality analysis"
        },
        {
          "name": "@runtime",
          "description": "Runtime behavior and dynamic configuration"
        },
        {
          "name": "@schema-validation",
          "description": "JSON Schema validation features and commands"
        },
        {
          "name": "@search",
          "description": "Search and query functionality for finding scenarios, work units, and code patterns"
        },
        {
          "name": "@server",
          "description": "Server-side components and HTTP endpoints"
        },
        {
          "name": "@session-based",
          "description": "Session-based interactive command pattern (similar to discover-foundation)"
        },
        {
          "name": "@setup",
          "description": "Setup and initialization commands"
        },
        {
          "name": "@similarity-matching",
          "description": "Text similarity and matching algorithms"
        },
        {
          "name": "@slash-command",
          "description": "Slash command features for Claude Code"
        },
        {
          "name": "@slash-commands",
          "description": "Claude Code slash command implementations"
        },
        {
          "name": "@sms",
          "description": "SMS-related functionality"
        },
        {
          "name": "@stable-indices",
          "description": "Stable indices system for maintaining unique IDs across soft-delete operations"
        },
        {
          "name": "@step-validation",
          "description": "Step-level validation and Gherkin step matching"
        },
        {
          "name": "@strategy-planning",
          "description": "Strategy planning and decision-making features that guide user choices"
        },
        {
          "name": "@system-reminder",
          "description": "Anti-drift pattern for AI agents using contextual reminders"
        },
        {
          "name": "@template",
          "description": "Template System"
        },
        {
          "name": "@template-generation",
          "description": "Template and documentation generation"
        },
        {
          "name": "@testing-framework",
          "description": "Testing framework and infrastructure features"
        },
        {
          "name": "@toml",
          "description": "TOML configuration file parsing and manipulation"
        },
        {
          "name": "@traceability",
          "description": "Scenario-to-test-to-implementation traceability and coverage tracking"
        },
        {
          "name": "@trackpad",
          "description": "Trackpad and touchpad input handling with smoothing and gesture support"
        },
        {
          "name": "@tree-sitter",
          "description": "Tree-sitter library for language-agnostic AST parsing"
        },
        {
          "name": "@type-system",
          "description": "Work unit type system features for categorizing work (story, task, bug)"
        },
        {
          "name": "@typescript",
          "description": "TypeScript-specific features and configuration"
        },
        {
          "name": "@ui-formatting",
          "description": "UI formatting and layout features"
        },
        {
          "name": "@ui-rendering",
          "description": "UI rendering and layout issues"
        },
        {
          "name": "@versioning",
          "description": "Version management and migration features"
        },
        {
          "name": "@vitest",
          "description": "Vitest testing framework related features"
        },
        {
          "name": "@web",
          "description": "Web-based features and browser functionality"
        },
        {
          "name": "@worker-threads",
          "description": "Features involving Node.js worker threads for parallel processing"
        },
        {
          "name": "@zoom",
          "description": "Zoom and scaling functionality for diagrams and visualizations"
        },
        {
          "name": "@zoom-pan",
          "description": "Zoom and pan interaction features"
        },
        {
          "name": "@zustand",
          "description": "Zustand state management library"
        }
      ],
      "rule": "Use technical tags to highlight specific architectural concerns."
    },
    {
      "name": "Platform Tags",
      "description": "Tags for platform-specific scenarios or cross-platform requirements.",
      "required": false,
      "tags": [
        {
          "name": "@claude-code",
          "description": "Features specific to Claude Code integration"
        },
        {
          "name": "@cross-platform",
          "description": "Cross-Platform Requirement"
        },
        {
          "name": "@linux",
          "description": "Linux-Specific"
        },
        {
          "name": "@macos",
          "description": "macOS-Specific"
        },
        {
          "name": "@windows",
          "description": "Windows-Specific"
        }
      ],
      "rule": "Use platform tags when a scenario has platform-specific behavior or requirements."
    },
    {
      "name": "Priority Tags",
      "description": "Tags indicating implementation priority or criticality.",
      "required": false,
      "tags": [
        {
          "name": "@breaking-change",
          "description": "Breaking changes requiring major version bump (v2.0+)"
        },
        {
          "name": "@critical",
          "description": "Critical Priority - Must Have"
        },
        {
          "name": "@high",
          "description": "High Priority - Should Have"
        },
        {
          "name": "@low",
          "description": "Low Priority - Future Enhancement"
        },
        {
          "name": "@medium",
          "description": "Medium Priority - Nice to Have"
        },
        {
          "name": "@p1",
          "description": "Phase 1 - Core foundation and infrastructure"
        },
        {
          "name": "@phase-1",
          "description": "Phase 1 features - core functionality"
        }
      ],
      "rule": "Use priority tags to guide implementation order within a phase."
    },
    {
      "name": "Status Tags",
      "description": "Tags tracking development status of features.",
      "required": false,
      "tags": [
        {
          "name": "@auth-002",
          "description": "Example work unit for authentication testing"
        },
        {
          "name": "@auth-999",
          "description": "Non-existent work unit for testing error handling"
        },
        {
          "name": "@blocked",
          "description": "Blocked"
        },
        {
          "name": "@bug",
          "description": "Bug fix work units"
        },
        {
          "name": "@bug-fix",
          "description": "Marks bug fixes and corrections to existing functionality"
        },
        {
          "name": "@deprecated",
          "description": "Deprecated"
        },
        {
          "name": "@done",
          "description": "Complete"
        },
        {
          "name": "@enhancement",
          "description": "Feature enhancement or improvement"
        },
        {
          "name": "@exmap-001",
          "description": "Work unit: Redesign Example Mapping to match BDD technique"
        },
        {
          "name": "@init-001",
          "description": "Work unit: Add ensureWorkUnitsFile to ALL 48+ commands"
        },
        {
          "name": "@partial",
          "description": "Partially implemented feature - work in progress"
        },
        {
          "name": "@refactor",
          "description": "Code refactoring and technical improvements"
        },
        {
          "name": "@refactoring",
          "description": "Code that needs refactoring"
        },
        {
          "name": "@remind-008",
          "description": "Feature file prefill detection and CLI enforcement work unit"
        },
        {
          "name": "@technical-debt",
          "description": "Technical debt that should be addressed"
        },
        {
          "name": "@test-001",
          "description": "Example test work unit"
        },
        {
          "name": "@todo",
          "description": "To Do"
        },
        {
          "name": "@wip",
          "description": "Work In Progress"
        }
      ],
      "rule": "Update status tags as features progress through development lifecycle."
    },
    {
      "name": "Testing Tags",
      "description": "Tags for test-related scenarios and requirements.",
      "required": false,
      "tags": [
        {
          "name": "@blocking",
          "description": "Operations that block workflow progression"
        },
        {
          "name": "@circular-dependency",
          "description": "Circular dependency detection tests"
        },
        {
          "name": "@complex-command",
          "description": "Complex command with multiple modes and options"
        },
        {
          "name": "@confirmation",
          "description": "Tests confirmation messages and user feedback"
        },
        {
          "name": "@consistency",
          "description": "Data consistency validation"
        },
        {
          "name": "@duplicate",
          "description": "Duplicate detection tests"
        },
        {
          "name": "@e2e",
          "description": "End-to-end integration tests"
        },
        {
          "name": "@e2e-test",
          "description": "End-to-End Test Required"
        },
        {
          "name": "@edge-case",
          "description": "Edge case tests - validation of boundary conditions and unusual scenarios"
        },
        {
          "name": "@happy-path",
          "description": "Happy path test scenarios"
        },
        {
          "name": "@integration-test",
          "description": "Integration Test Required"
        },
        {
          "name": "@main-help",
          "description": "Main help menu tests"
        },
        {
          "name": "@manual-test",
          "description": "Requires Manual Testing"
        },
        {
          "name": "@medium-command",
          "description": "Medium complexity command with multiple options"
        },
        {
          "name": "@overwrite",
          "description": "Tests overwrite behavior (file replacement without prompts)"
        },
        {
          "name": "@prerequisites",
          "description": "Prerequisite validation scenarios"
        },
        {
          "name": "@regression",
          "description": "Regression tests - comprehensive validation of existing functionality"
        },
        {
          "name": "@simple-command",
          "description": "Simple command with minimal options"
        },
        {
          "name": "@smoke",
          "description": "Smoke tests - quick validation of critical functionality"
        },
        {
          "name": "@test-infrastructure",
          "description": "Test infrastructure and framework code"
        },
        {
          "name": "@test-isolation",
          "description": "Test isolation and concurrent execution"
        },
        {
          "name": "@unit-test",
          "description": "Unit Test Coverage Required"
        },
        {
          "name": "@unregistered-scenario-tag",
          "description": "Example tag used in test scenarios to demonstrate error handling"
        },
        {
          "name": "@unregistered-tag1",
          "description": "Example tag used in test scenarios to demonstrate error handling"
        },
        {
          "name": "@unregistered-tag2",
          "description": "Example tag used in test scenarios to demonstrate error handling"
        },
        {
          "name": "@warning",
          "description": "Operations that produce warnings"
        }
      ],
      "rule": "Use testing tags to indicate what level of testing is required for a scenario."
    },
    {
      "name": "Automation Tags",
      "description": "Tags for automation integration and agentic coding workflows.",
      "required": false,
      "tags": [
        {
          "name": "@acdd",
          "description": "Acceptance Criteria Driven Development"
        },
        {
          "name": "@cli-integration",
          "description": "CLI integration and workflow automation features"
        },
        {
          "name": "@discovery-workflow",
          "description": "Discovery workflow and bootstrapping processes"
        },
        {
          "name": "@draft-driven",
          "description": "Draft-driven development and feedback loops"
        },
        {
          "name": "@execa",
          "description": "Child process execution integration point"
        },
        {
          "name": "@spec-alignment",
          "description": "Specification Alignment"
        }
      ],
      "rule": "Use automation tags to indicate integration points with automation systems and lifecycle hooks."
    }
  ],
  "combinationExamples": [
    {
      "title": "Example 1: Phase 1 Feature File Creation",
      "tags": "@phase1 @cli @generator @feature-management @gherkin @cross-platform @critical @unit-test @integration-test\nFeature: Create Feature File with Template",
      "interpretation": [
        "Phase 1 feature",
        "Belongs to CLI and generator components",
        "Part of feature management functionality",
        "Ensures Gherkin compliance",
        "Must work on all platforms",
        "Critical priority (core functionality)",
        "Requires both unit and integration tests"
      ]
    },
    {
      "title": "Example 2: Phase 2 Tag Registry Validation",
      "tags": "@phase2 @validator @tag-management @validation @error-handling @high @integration-test @hook\nFeature: Validate Feature File Tags Against Registry",
      "interpretation": [
        "Phase 2 feature",
        "Belongs to validator component",
        "Part of tag management functionality",
        "Includes validation and error handling",
        "High priority",
        "Requires integration tests",
        "Called from lifecycle hooks"
      ]
    },
    {
      "title": "Example 3: Phase 3 Advanced Querying",
      "tags": "@phase3 @cli @querying @parser @ast @medium @unit-test @e2e-test\nFeature: Advanced Scenario Search and Filtering",
      "interpretation": [
        "Phase 3 feature",
        "Belongs to CLI and querying components",
        "Uses parser and AST processing",
        "Medium priority",
        "Requires unit and end-to-end tests"
      ]
    }
  ],
  "usageGuidelines": {
    "requiredCombinations": {
      "title": "Required Tag Combinations",
      "requirements": [
        "One Phase Tag: @phase1, @phase2, or @phase3",
        "At least One Component Tag: @cli, @parser, @generator, @validator, etc.",
        "At least One Feature Group Tag: @feature-management, @tag-management, etc."
      ],
      "minimumExample": "@phase1 @cli @feature-management\nFeature: Minimal Valid Feature"
    },
    "recommendedCombinations": {
      "title": "Recommended Tag Combinations",
      "includes": [
        "Required tags (phase, component, feature group)",
        "Technical tags for key architectural concerns",
        "Platform tags if platform-specific",
        "Priority tag for implementation planning",
        "Testing tags for test strategy",
        "Automation integration tags if applicable"
      ],
      "recommendedExample": "@phase1 @cli @parser @validation @gherkin @cucumber-parser @error-handling @cross-platform @critical @integration-test @hook\nFeature: Gherkin Syntax Validation"
    },
    "orderingConvention": {
      "title": "Tag Ordering Convention",
      "order": [
        "Phase tag",
        "Component tag(s)",
        "Feature group tag(s)",
        "Technical tags",
        "Platform tags",
        "Priority tag",
        "Status tag",
        "Testing tags",
        "Automation integration tags"
      ],
      "example": "@phase2 @cli @validator @tag-management @validation @mermaid @cross-platform @high @wip @integration-test @hook\nFeature: FOUNDATION.md Mermaid Diagram Validation"
    }
  },
  "addingNewTags": {
    "process": [
      {
        "step": "Identify Need",
        "description": "Determine if existing tags are insufficient"
      },
      {
        "step": "Check Registry",
        "description": "Verify tag doesn't already exist in this document"
      },
      {
        "step": "Define Tag",
        "description": "Create clear description and usage guidelines"
      },
      {
        "step": "Update TAGS.md",
        "description": "Add to appropriate category table"
      },
      {
        "step": "Document Examples",
        "description": "Show how tag should be used"
      },
      {
        "step": "Use fspec",
        "description": "Register tag using `fspec register-tag` command"
      },
      {
        "step": "Apply",
        "description": "Use tag in feature files"
      }
    ],
    "namingConventions": [
      "Use lowercase",
      "Use hyphens for multi-word tags (@cross-platform, not @crossplatform)",
      "Be specific and descriptive (@cucumber-parser not @parser-integration)",
      "Avoid redundancy (@cli-commands → just @cli)",
      "Keep concise (prefer @wip over @work-in-progress)"
    ],
    "antiPatterns": {
      "dont": [
        {
          "description": "Create overlapping tags",
          "example": "@validate and @validation → use @validation"
        },
        {
          "description": "Use vague tags",
          "example": "@important → use @critical, @high, etc."
        },
        {
          "description": "Create single-use tags",
          "example": "@login-feature → use combination of existing tags"
        },
        {
          "description": "Mix concerns",
          "example": "@cli-validation → use @cli @validation"
        }
      ],
      "do": [
        {
          "description": "Reuse existing tags through combinations"
        },
        {
          "description": "Create specific technical tags",
          "example": "@gherkin, @mermaid"
        },
        {
          "description": "Document new tags thoroughly"
        },
        {
          "description": "Use tags to enable filtering and reporting"
        }
      ]
    }
  },
  "queries": {
    "title": "Common Tag Queries",
    "examples": [
      {
        "description": "All Phase 1 features",
        "command": "fspec list-features --tag=@phase1"
      },
      {
        "description": "Critical validation features",
        "command": "fspec list-features --tag=@validation --tag=@critical"
      },
      {
        "description": "Features requiring integration tests",
        "command": "fspec list-features --tag=@integration-test"
      },
      {
        "description": "Lifecycle hook integration points",
        "command": "fspec list-features --tag=@hook"
      },
      {
        "description": "Cross-platform CLI features",
        "command": "fspec list-features --tag=@cli --tag=@cross-platform"
      }
    ]
  },
  "statistics": {
    "lastUpdated": "2025-11-18T02:38:59.960Z",
    "phaseStats": [
      {
        "phase": "Phase 1",
        "total": 5,
        "complete": 5,
        "inProgress": 0,
        "planned": 0
      },
      {
        "phase": "Phase 2",
        "total": 7,
        "complete": 7,
        "inProgress": 0,
        "planned": 0
      },
      {
        "phase": "Phase 3",
        "total": 2,
        "complete": 2,
        "inProgress": 0,
        "planned": 0
      },
      {
        "phase": "Phase 4",
        "total": 4,
        "complete": 4,
        "inProgress": 0,
        "planned": 0
      },
      {
        "phase": "Phase 5",
        "total": 7,
        "complete": 7,
        "inProgress": 0,
        "planned": 0
      },
      {
        "phase": "Phase 6",
        "total": 3,
        "complete": 3,
        "inProgress": 0,
        "planned": 0
      },
      {
        "phase": "Total",
        "total": 28,
        "complete": 28,
        "inProgress": 0,
        "planned": 0
      }
    ],
    "componentStats": [
      {
        "component": "@cli",
        "count": 28,
        "percentage": "100%"
      },
      {
        "component": "@parser",
        "count": 3,
        "percentage": "11%"
      },
      {
        "component": "@generator",
        "count": 1,
        "percentage": "4%"
      },
      {
        "component": "@validator",
        "count": 1,
        "percentage": "4%"
      },
      {
        "component": "@formatter",
        "count": 1,
        "percentage": "4%"
      },
      {
        "component": "@file-ops",
        "count": 1,
        "percentage": "4%"
      }
    ],
    "featureGroupStats": [
      {
        "featureGroup": "@feature-management",
        "count": 11,
        "percentage": "39%"
      },
      {
        "featureGroup": "@modification",
        "count": 11,
        "percentage": "39%"
      },
      {
        "featureGroup": "@tag-management",
        "count": 7,
        "percentage": "25%"
      },
      {
        "featureGroup": "@querying",
        "count": 6,
        "percentage": "21%"
      },
      {
        "featureGroup": "@foundation-management",
        "count": 3,
        "percentage": "11%"
      },
      {
        "featureGroup": "@bulk-operations",
        "count": 3,
        "percentage": "11%"
      },
      {
        "featureGroup": "@validation",
        "count": 3,
        "percentage": "11%"
      },
      {
        "featureGroup": "@documentation",
        "count": 2,
        "percentage": "7%"
      },
      {
        "featureGroup": "@read-only",
        "count": 2,
        "percentage": "7%"
      },
      {
        "featureGroup": "@formatting",
        "count": 1,
        "percentage": "4%"
      },
      {
        "featureGroup": "@utility",
        "count": 1,
        "percentage": "4%"
      }
    ],
    "updateCommand": "fspec tag-stats"
  },
  "validation": {
    "rules": [
      {
        "rule": "Registry Compliance",
        "description": "All tags in feature files MUST exist in this TAGS.md"
      },
      {
        "rule": "Required Tags",
        "description": "Every feature MUST have phase + component + feature group tags"
      },
      {
        "rule": "No Orphans",
        "description": "Tags in TAGS.md should be used in at least one feature file"
      },
      {
        "rule": "Consistent Naming",
        "description": "Follow tag naming conventions strictly"
      }
    ],
    "commands": [
      {
        "description": "Validate all feature files",
        "command": "fspec validate-tags"
      },
      {
        "description": "Check for orphaned tags",
        "command": "fspec tag-stats --show-orphans"
      },
      {
        "description": "Validate specific feature",
        "command": "fspec validate login.feature"
      }
    ]
  },
  "references": [
    {
      "title": "Gherkin Reference",
      "url": "https://cucumber.io/docs/gherkin/reference/#tags"
    },
    {
      "title": "Cucumber Tag Expressions",
      "url": "https://cucumber.io/docs/cucumber/api/#tag-expressions"
    }
  ]
}