How rogasper/system-analyst-skill works
FSD Analyzer is an agent skill that guides an AI coding assistant from functional requirements to technical artifacts and analysis. Its principal workflow is to interpret an FSD, optionally resolve ambiguity, then produce specifications, models, tasks, and planning outputs; separate modes compare or check existing artifacts. The README documents these capabilities, while the sampled Python scripts implement only optional local validation and entity-extraction helpers. Unsampled skill and reference contents limit claims about internal call flow.
Main entry points: SKILL.md Analyzer Skill · app.py Optional Web UI · extract_entities.py Entity Hints · validate_erd.py DBML Validator
Components 24
FSD Workflow
- Analyzer Skill
SKILL.md - Project Context
references/project_context_template.md - Discovery Questions
references/discovery_questions.md
Artifact Generation
- API Specification
references/spec_api_format.md - ERD and DBML
references/erd_format.md - UML Diagrams
references/uml_format.md - Developer Tasks
references/task_format.md - Frontend Tasks
references/frontend_task_format.md - OpenAPI Output
references/openapi_format.md - Traceability Matrix
references/rtm_format.md - Auth and Security
references/auth_security.md - Error Catalog
references/error_catalog.md
Analysis and Planning
- Gap Analysis
references/gap_analysis.md - Consistency Check
references/consistency_check.md - Timeline Planning
references/timeline_estimation.md - Migration Plan
references/migration_strategy.md - Master Artifacts
references/master_artifacts.md
Local Helpers
- Entity Hints
scripts/extract_entities.py - DBML Validator
scripts/validate_erd.py - Spec Validator
scripts/validate_spec.py - Artifact Comparator
scripts/compare_artifacts.py - Optional Web UI
optional_web/app.py
Other components
- Product Analyst
- AI Assistant
Connections 25
- Product Analyst → AI Assistant: provides requirements
README.md - AI Assistant → Analyzer Skill: uses skill
README.md - Analyzer Skill → Project Context: uses context template
README.md - Analyzer Skill → Discovery Questions: supports discovery
README.md - Analyzer Skill → API Specification: generates specs
README.md - Analyzer Skill → ERD and DBML: generates schemas
README.md - Analyzer Skill → UML Diagrams: generates diagrams
README.md - Analyzer Skill → Developer Tasks: generates task cards
README.md - Analyzer Skill → Frontend Tasks: generates frontend tasks
README.md - Analyzer Skill → OpenAPI Output: consolidates specs
README.md - Analyzer Skill → Traceability Matrix: traces requirements
README.md - Analyzer Skill → Auth and Security: documents security
README.md - Analyzer Skill → Error Catalog: defines error conventions
README.md - Analyzer Skill → Gap Analysis: compares artifacts
README.md - Analyzer Skill → Consistency Check: checks consistency
README.md - Analyzer Skill → Timeline Planning: estimates timeline
README.md - Analyzer Skill → Migration Plan: plans migration
README.md - Analyzer Skill → Master Artifacts: supports incremental work
README.md - AI Assistant → Entity Hints: runs optional helper
README.md - AI Assistant → DBML Validator: runs optional helper
README.md - AI Assistant → Spec Validator: runs optional helper
README.md - AI Assistant → Artifact Comparator: runs optional helper
README.md - Optional Web UI → Entity Hints: runs script
optional_web/app.py - Optional Web UI → DBML Validator: runs script
optional_web/app.py - Optional Web UI → Spec Validator: runs script
optional_web/app.py