ai-spector 0.1.1

package/_templates/srs/7-quality-attributes.md

@@ -0,0 +1,74 @@
+## 7. Non-Functional Requirements (Quality Attributes)
+
+> This section specifies the non-functional requirements that define the quality attributes, constraints, and performance characteristics of the system. These requirements describe how the system should behave rather than what functions it should perform.
+
+### 7.1 Usability
+
+> Specify any requirements regarding characteristics that will make the software appear to be "user-friendly."
+
+**Requirements:**
+- **Ease of Use:** <Requirement>
+- **Ease of Learning:** <Requirement>
+- **Accessibility:** <Requirement>
+- **Error Handling:** <Requirement>
+
+**UI Design Standards:**
+- <Standard 1>
+- <Standard 2>
+
+### 7.2 Performance
+
+> State specific performance requirements for various system operations.
+
+| Operation | Response Time Requirement |
+|-----------|---------------------------|
+| <Operation 1> | <Time requirement> |
+| <Operation 2> | <Time requirement> |
+
+**Throughput Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+### 7.3 Security
+
+> Specify any requirements regarding security or privacy issues.
+
+**Requirements:**
+- **Access Control:** <Requirement>
+- **Authentication:** <Requirement>
+- **Authorization:** <Requirement>
+- **Data Security:** <Requirement>
+- **Privacy:** <Requirement>
+
+**Compliance:**
+- <Compliance requirement 1>
+- <Compliance requirement 2>
+
+### 7.4 Safety
+
+> Specify requirements that are concerned with possible loss, damage, or harm.
+
+**Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Safeguards:**
+- <Safeguard 1>
+- <Safeguard 2>
+
+### 7.5 Others as relevant
+
+> Create a separate section for each additional product quality attribute.
+
+**Availability:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Reliability:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Maintainability:**
+- <Requirement 1>
+- <Requirement 2>
+

package/_templates/srs/8-internationalization.md

@@ -0,0 +1,36 @@
+## 8. Internationalization and Localization Requirements
+
+> Internationalization and localization requirements ensure that the product will be suitable for use in nations, cultures, and geographic locations other than those in which it was created.
+
+**Supported Languages:**
+
+- <Language 1>
+- <Language 2>
+
+**Supported Locales:**
+
+- <Locale 1>
+- <Locale 2>
+
+**Formatting Requirements:**
+
+- **Currency:** 
+- **Date/Time:** 
+- **Numbers:** 
+- **Addresses:** 
+
+**Character Sets:**
+
+- <Requirement 1>
+- <Requirement 2>
+
+**Cultural Considerations:**
+
+- <Consideration 1>
+- <Consideration 2>
+
+**Regulatory Compliance:**
+
+- <Regulation 1>
+- <Regulation 2>
+

package/_templates/srs/9-other-requirements.md

@@ -0,0 +1,46 @@
+## 9. Other Requirements
+
+> Examples are: legal, regulatory or financial compliance, and standards requirements; requirements for product installation, configuration, startup, and shutdown; and logging, monitoring and audit trail requirements.
+
+### 9.1 Legal and Regulatory Compliance
+
+**Legal Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Regulatory Compliance:**
+- <Compliance requirement 1>
+- <Compliance requirement 2>
+
+**Standards Compliance:**
+- <Standard 1>
+- <Standard 2>
+
+### 9.2 Installation and Configuration
+
+**Installation Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Configuration Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Startup/Shutdown Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+### 9.3 Logging and Monitoring
+
+**Logging Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Monitoring Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+
+**Audit Trail Requirements:**
+- <Requirement 1>
+- <Requirement 2>
+

package/assets/cursor/commands/analyze.md

@@ -0,0 +1,39 @@
+# /analyze
+
+Analyze project sources and produce normalized knowledge artifacts for downstream document generation.
+
+## Usage
+
+- `/analyze`
+  - Analyze current workspace folder.
+- `/analyze <path1> <path2> ...`
+  - Analyze only provided files/folders.
+
+## Required Behavior
+
+1. Resolve and normalize input paths.
+   - If no path is provided, use workspace root as source.
+   - Skip invalid paths with warnings.
+2. Build/update Graphify index through MCP.
+3. Query graph to extract canonical sections:
+   - actors
+   - useCases
+   - features
+   - functionalRequirements
+   - nfrs
+   - entities
+   - interfaces
+   - constraints
+   - openQuestions
+4. Use MCP text/semantic fallback when graph results are incomplete.
+5. Persist artifacts:
+   - `docs/.docflow/analysis/knowledge.json`
+   - `docs/.docflow/analysis/gaps.json`
+   - `docs/.docflow/analysis/scope.json`
+6. Update `docs/.docflow/state.json` with analysis timestamp and scope hash.
+
+## Success Criteria
+
+- Graphify contains current source scope.
+- `knowledge.json` has all canonical keys.
+- Missing information is explicit in `gaps.json`.

package/assets/cursor/commands/generate-detail-design.md

@@ -0,0 +1,35 @@
+# /generate-detail-design
+
+Generate detail design documents incrementally from SRS + Graphify context with dependency-aware parallelism.
+
+## Usage
+
+- `/generate-detail-design`
+  - Continue mode: scan existing files and fill missing/incomplete outputs only.
+- `/generate-detail-design <file>`
+  - Target a single detail-design file.
+
+## Required Behavior
+
+1. Load:
+   - `docs/.docflow/analysis/knowledge.json`
+   - `docs/output/srs/*`
+   - `docs/.docflow/config/dag.detail-design.json`
+   - `docs/.docflow/config/completeness-rules.detail-design.json`
+2. Scan existing outputs under `docs/output/detail-design/` and classify:
+   - `good`
+   - `missing_content`
+   - `missing_file`
+3. Process DAG in waves:
+   - generate or patch only `missing_content` and `missing_file`
+   - run independent nodes in parallel subagents
+4. Merge each wave:
+   - verify consistency with SRS references
+   - normalize architecture/security/performance references
+5. Sync each generated/updated file into Graphify immediately.
+6. Persist updated state and run log.
+
+## Guardrails
+
+- Do not overwrite `good` files unless force mode is requested.
+- If required SRS dependencies are absent, stop and request `/generate-srs` first.

package/assets/cursor/commands/generate-srs.md

@@ -0,0 +1,38 @@
+# /generate-srs
+
+Generate SRS files incrementally in dependency order using templates, Graphify knowledge, and parallel subagents.
+
+## Usage
+
+- `/generate-srs`
+  - Continue mode by default: scan existing files and generate only missing/incomplete nodes.
+- `/generate-srs <file>`
+  - Generate/repair one target file while validating prerequisites.
+
+## Required Behavior
+
+1. Load:
+   - `docs/.docflow/analysis/knowledge.json`
+   - `docs/.docflow/config/dag.srs.json`
+   - `docs/.docflow/config/completeness-rules.srs.json`
+2. Scan existing outputs under `docs/output/srs/` and classify each target node:
+   - `good`
+   - `missing_content`
+   - `missing_file`
+3. Skip `good` nodes by default.
+4. Build generation queue by DAG wave order:
+   - process only `missing_file` and `missing_content`
+   - run independent nodes in parallel subagents
+5. Merge and review each wave:
+   - normalize IDs and terminology
+   - validate links and cross references
+   - preserve manual content when patching existing files
+6. After each written file, sync file content back into Graphify.
+7. Update run logs and state:
+   - `docs/.docflow/logs/run-<timestamp>.md`
+   - `docs/.docflow/state.json`
+
+## Guardrails
+
+- Never overwrite `good` files unless force mode is requested.
+- If analysis scope is stale or missing, request `/analyze` first.

package/assets/cursor/skills/spec-writer/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: spec-writer
+description: "Incremental documentation workflow for analyze -> SRS -> detail design using Graphify MCP, dependency DAGs, and parallel subagents."
+---
+
+# Spec Writer Skill
+
+Use this skill when the user requests document generation from project data and templates.
+
+## Workflow
+
+1. Run `/analyze` to build and query Graphify knowledge for current scope.
+2. Run `/generate-srs` to produce SRS documents in DAG order.
+3. Run `/generate-detail-design` to produce detail design docs from SRS + Graphify context.
+
+## Core Rules
+
+- Always work incrementally.
+- Scan outputs before generating and classify `good`, `missing_content`, `missing_file`.
+- Skip `good` by default.
+- Patch incomplete files rather than replacing valid sections.
+- Generate independent nodes in parallel using subagents.
+- Merge and normalize content in main agent after each wave.
+- Sync generated files back into Graphify after each write.
+
+## Inputs and Outputs
+
+- Templates: `docs/_templates/*`
+- Analysis artifacts: `docs/.docflow/analysis/*`
+- Runtime state: `docs/.docflow/state.json`
+- Outputs:
+  - `docs/output/srs/*`
+  - `docs/output/detail-design/*`

package/assets/workflow/config/analyze.graphify.json

@@ -0,0 +1,36 @@
+{
+  "version": 1,
+  "graphify": {
+    "indexPath": "docs/.docflow/graph/graphify-index",
+    "include": [
+      "."
+    ],
+    "exclude": [
+      ".git/**",
+      "node_modules/**",
+      "dist/**",
+      "build/**",
+      ".next/**",
+      "coverage/**",
+      "docs/output/**"
+    ]
+  },
+  "queryProfiles": [
+    {
+      "name": "actors-and-use-cases",
+      "goal": "Extract users, actors, and end-to-end use cases."
+    },
+    {
+      "name": "feature-map",
+      "goal": "Extract features, dependencies, and requirement groupings."
+    },
+    {
+      "name": "data-and-interfaces",
+      "goal": "Extract entities, data flows, and external/internal interfaces."
+    },
+    {
+      "name": "nfr-and-constraints",
+      "goal": "Extract quality attributes, constraints, and operational requirements."
+    }
+  ]
+}

package/assets/workflow/config/completeness-rules.detail-design.json

@@ -0,0 +1,57 @@
+{
+  "version": 1,
+  "defaultChecks": {
+    "disallowPlaceholders": [
+      "<",
+      "TODO",
+      "TBD"
+    ],
+    "requireNonEmptyTables": true,
+    "validateMarkdownLinks": true
+  },
+  "rules": [
+    {
+      "target": "feature-list.md",
+      "requiredHeadings": [
+        "# Detail Design: Feature List",
+        "## 1. List of Features"
+      ]
+    },
+    {
+      "target": "common/architecture-overview.md",
+      "requiredHeadings": [
+        "# Architecture Overview"
+      ]
+    },
+    {
+      "target": "common/security-patterns.md",
+      "requiredHeadings": [
+        "# Security Patterns"
+      ]
+    },
+    {
+      "target": "common/error-handling-patterns.md",
+      "requiredHeadings": [
+        "# Error Handling Patterns"
+      ]
+    },
+    {
+      "target": "common/performance-standards.md",
+      "requiredHeadings": [
+        "# Performance Standards"
+      ]
+    },
+    {
+      "target": "common/integration-patterns.md",
+      "requiredHeadings": [
+        "# Integration Patterns"
+      ]
+    },
+    {
+      "target": "common/deployment-infrastructure.md",
+      "requiredHeadings": [
+        "# Deployment and Infrastructure"
+      ]
+    }
+  ]
+}

package/assets/workflow/config/completeness-rules.srs.json

@@ -0,0 +1,72 @@
+{
+  "version": 1,
+  "defaultChecks": {
+    "disallowPlaceholders": [
+      "<",
+      "TODO",
+      "TBD"
+    ],
+    "requireNonEmptyTables": true,
+    "validateMarkdownLinks": true
+  },
+  "rules": [
+    {
+      "target": "1-introduction.md",
+      "requiredHeadings": [
+        "## 1. Introduction",
+        "### 1.1 Document Purpose",
+        "### 1.3 Project Scope"
+      ]
+    },
+    {
+      "target": "2-overall-description.md",
+      "requiredHeadings": [
+        "## 2. Overall Description"
+      ]
+    },
+    {
+      "target": "3-use-cases.md",
+      "requiredHeadings": [
+        "## 3. Use Cases",
+        "### 3.1 Use Case Diagrams",
+        "### 3.2 List Use Case"
+      ]
+    },
+    {
+      "target": "4-system-features.md",
+      "requiredHeadings": [
+        "## 4. System Features"
+      ]
+    },
+    {
+      "target": "5-data-requirements.md",
+      "requiredHeadings": [
+        "## 5. Data Requirements"
+      ]
+    },
+    {
+      "target": "6-external-interfaces.md",
+      "requiredHeadings": [
+        "## 6. External Interface Requirements"
+      ]
+    },
+    {
+      "target": "7-quality-attributes.md",
+      "requiredHeadings": [
+        "## 7. Quality Attributes"
+      ]
+    },
+    {
+      "target": "8-internationalization.md",
+      "requiredHeadings": [
+        "## 8. Internationalization and Localization"
+      ]
+    },
+    {
+      "target": "9-other-requirements.md",
+      "requiredHeadings": [
+        "## 9. Other Requirements"
+      ]
+    }
+  ]
+}

package/assets/workflow/config/dag.detail-design.json

@@ -0,0 +1,64 @@
+{
+  "version": 1,
+  "root": "docs/output/detail-design",
+  "nodes": [
+    {
+      "id": "dd.common.architecture-overview",
+      "template": "detail_design/common/architecture-overview-template.md",
+      "output": "common/architecture-overview.md",
+      "dependsOn": []
+    },
+    {
+      "id": "dd.common.security-patterns",
+      "template": "detail_design/common/security-patterns-template.md",
+      "output": "common/security-patterns.md",
+      "dependsOn": []
+    },
+    {
+      "id": "dd.common.error-handling",
+      "template": "detail_design/common/error-handling-patterns-template.md",
+      "output": "common/error-handling-patterns.md",
+      "dependsOn": []
+    },
+    {
+      "id": "dd.common.performance-standards",
+      "template": "detail_design/common/performance-standards-template.md",
+      "output": "common/performance-standards.md",
+      "dependsOn": []
+    },
+    {
+      "id": "dd.common.integration-patterns",
+      "template": "detail_design/common/integration-patterns-template.md",
+      "output": "common/integration-patterns.md",
+      "dependsOn": []
+    },
+    {
+      "id": "dd.common.deployment",
+      "template": "detail_design/common/deployment-infrastructure-template.md",
+      "output": "common/deployment-infrastructure.md",
+      "dependsOn": []
+    },
+    {
+      "id": "dd.feature-list",
+      "template": "detail_design/feature-list-template.md",
+      "output": "feature-list.md",
+      "dependsOn": [
+        "dd.common.architecture-overview",
+        "dd.common.security-patterns",
+        "dd.common.error-handling",
+        "dd.common.performance-standards",
+        "dd.common.integration-patterns",
+        "dd.common.deployment"
+      ]
+    },
+    {
+      "id": "dd.feature-details",
+      "template": "detail_design/feature-detail-design-template.md",
+      "output": "features/",
+      "dependsOn": [
+        "dd.feature-list"
+      ],
+      "mode": "perFeature"
+    }
+  ]
+}

package/assets/workflow/config/dag.srs.json

@@ -0,0 +1,87 @@
+{
+  "version": 1,
+  "root": "docs/output/srs",
+  "nodes": [
+    {
+      "id": "srs.introduction",
+      "template": "srs/1-introduction.md",
+      "output": "1-introduction.md",
+      "dependsOn": []
+    },
+    {
+      "id": "srs.overall-description",
+      "template": "srs/2-overall-description.md",
+      "output": "2-overall-description.md",
+      "dependsOn": []
+    },
+    {
+      "id": "srs.use-cases",
+      "template": "srs/3-use-cases.md",
+      "output": "3-use-cases.md",
+      "dependsOn": [
+        "srs.introduction",
+        "srs.overall-description"
+      ]
+    },
+    {
+      "id": "srs.features-list",
+      "template": "srs/4-system-features-list-template.md",
+      "output": "4-system-features.md",
+      "dependsOn": [
+        "srs.use-cases"
+      ]
+    },
+    {
+      "id": "srs.feature-details",
+      "template": "srs/4-system-feature-detail-template.md",
+      "output": "features/",
+      "dependsOn": [
+        "srs.features-list"
+      ],
+      "mode": "perFeature"
+    },
+    {
+      "id": "srs.data-requirements",
+      "template": "srs/5-data-requirements.md",
+      "output": "5-data-requirements.md",
+      "dependsOn": [
+        "srs.feature-details"
+      ]
+    },
+    {
+      "id": "srs.external-interfaces",
+      "template": "srs/6-external-interfaces.md",
+      "output": "6-external-interfaces.md",
+      "dependsOn": [
+        "srs.feature-details"
+      ]
+    },
+    {
+      "id": "srs.quality-attributes",
+      "template": "srs/7-quality-attributes.md",
+      "output": "7-quality-attributes.md",
+      "dependsOn": [
+        "srs.data-requirements",
+        "srs.external-interfaces"
+      ]
+    },
+    {
+      "id": "srs.internationalization",
+      "template": "srs/8-internationalization.md",
+      "output": "8-internationalization.md",
+      "dependsOn": [
+        "srs.data-requirements",
+        "srs.external-interfaces"
+      ]
+    },
+    {
+      "id": "srs.other-requirements",
+      "template": "srs/9-other-requirements.md",
+      "output": "9-other-requirements.md",
+      "dependsOn": [
+        "srs.data-requirements",
+        "srs.external-interfaces"
+      ]
+    }
+  ]
+}

package/assets/workflow/state/state.template.json

@@ -0,0 +1,26 @@
+{
+  "version": 1,
+  "analysis": {
+    "lastRunAt": null,
+    "scopeHash": null,
+    "sources": []
+  },
+  "graphify": {
+    "ready": false,
+    "installedByInit": false,
+    "lastBootstrapAt": null,
+    "lastSyncedFiles": []
+  },
+  "srs": {
+    "completed": [],
+    "inProgress": [],
+    "failed": [],
+    "artifacts": {}
+  },
+  "detailDesign": {
+    "completed": [],
+    "inProgress": [],
+    "failed": [],
+    "artifacts": {}
+  }
+}