Skip to content

chore: roadmap planning — 6 spec closures, 3 new roadmap specs, FSM short-circuit #33

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
darko-mijic wants to merge 3 commits into
base: main
Choose a base branch
from
Open

chore: roadmap planning — 6 spec closures, 3 new roadmap specs, FSM short-circuit #33

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
422e587
fix: allow unlock-reason to bypass FSM transition checks for existing…
darko-mijic Mar 6, 2026
12ae696
chore: roadmap planning — 6 spec closures, 3 new roadmap specs, FSM s…
darko-mijic Mar 6, 2026
6019788
fix: address PR #33 review comments — tighten unlock bypass, validate…
darko-mijic Mar 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
97 changes: 0 additions & 97 deletions _claude-md/workflow/session-workflows.md
View file
Open in desktop

This file was deleted.

21 changes: 11 additions & 10 deletions delivery-process/specs/architecture-diagram-advanced.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
@libar-docs
@libar-docs-pattern:ArchitectureDiagramAdvanced
@libar-docs-status:roadmap
@libar-docs-status:completed
@libar-docs-unlock-reason:Retroactive-completion
@libar-docs-phase:23
@libar-docs-effort:1w
@libar-docs-product-area:Generation
Expand Down Expand Up @@ -29,9 +30,9 @@ Feature: Architecture Diagram Generation - Advanced
Given the following deliverables:
| Deliverable | Status | Location | Tests | Test Type |
| ArchitectureCodec (layered) | complete | renderable/codecs/architecture.ts | Yes | unit |
| Architecture generator | pending | generators/built-in/architecture.ts | Yes | unit |
| Example app annotations | pending | examples/sample-project/src/ | No | - |
| Sequence diagram support | pending | renderable/codecs/architecture.ts | Yes | unit |
| Architecture generator | complete | generators/built-in/codec-generators.ts | Yes | unit |
| Example app annotations | n/a | examples/sample-project/src/ | No | - |
| Sequence diagram support | superseded | renderable/codecs/architecture.ts | Yes | unit |

# ============================================================================
# RULE 5: Layered Diagram Generation
Expand All @@ -43,9 +44,9 @@ Feature: Architecture Diagram Generation - Advanced
layer (domain, application, infrastructure) with top-to-bottom flow.

**Rationale:** Layered architecture visualization shows dependency direction -
infrastructure at top, domain at bottom - following conventional layer ordering.
domain at top, infrastructure at bottom - following conventional layer ordering.

**Verified by:** Generate subgraphs per layer, Layer order is infrastructure-application-domain,
**Verified by:** Generate subgraphs per layer, Layer order is domain-application-infrastructure,
Include context label in node names

@acceptance-criteria @happy-path
Expand All @@ -61,11 +62,11 @@ Feature: Architecture Diagram Generation - Advanced
And output contains subgraph "Infrastructure Layer"

@acceptance-criteria @happy-path
Scenario: Layer order is infrastructure-application-domain
Scenario: Layer order is domain-application-infrastructure
Given patterns with all three layers
When the layered diagram codec runs
Then Infrastructure Layer appears before Application Layer in output
And Application Layer appears before Domain Layer in output
Then Domain Layer appears before Application Layer in output
And Application Layer appears before Infrastructure Layer in output

@acceptance-criteria @happy-path
Scenario: Include context label in node names
Expand Down Expand Up @@ -118,7 +119,7 @@ Feature: Architecture Diagram Generation - Advanced
Scenario: Generator option for layered diagram
When running generate-docs with --generators architecture --diagram-type layered
Then output contains layer subgraphs
And output follows infrastructure-application-domain order
And output follows domain-application-infrastructure order

@acceptance-criteria @happy-path
Scenario: Generator option for context filtering
Expand Down
3 changes: 2 additions & 1 deletion delivery-process/specs/architecture-diagram-core.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
@libar-docs
@libar-docs-pattern:ArchitectureDiagramCore
@libar-docs-status:roadmap
@libar-docs-status:completed
@libar-docs-unlock-reason:Retroactive-completion
@libar-docs-phase:23
@libar-docs-effort:1w
@libar-docs-product-area:Generation
Expand Down
2 changes: 1 addition & 1 deletion delivery-process/specs/data-api-cli-ergonomics.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Feature: Data API CLI Ergonomics - Performance and Interactive Mode
| Deliverable | Status | Location | Tests | Test Type |
| MasterDataset cache with mtime invalidation | pending | src/cli/dataset-cache.ts | Yes | unit |
| REPL mode handler | pending | src/cli/repl.ts | Yes | integration |
| FSM short-circuit for static queries | pending | src/cli/process-api.ts | Yes | unit |
| FSM short-circuit for static queries | complete | src/cli/process-api.ts | Yes | unit |
| Per-subcommand help system | pending | src/cli/process-api.ts | Yes | integration |
| Dry-run mode | pending | src/cli/process-api.ts | Yes | integration |
| Validation summary in metadata | pending | src/cli/process-api.ts | Yes | unit |
Expand Down
25 changes: 16 additions & 9 deletions delivery-process/specs/data-api-platform-integration.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
@libar-docs
@libar-docs-pattern:DataAPIPlatformIntegration
@libar-docs-status:roadmap
@libar-docs-status:completed
@libar-docs-unlock-reason:Split-into-dedicated-specs
@libar-docs-phase:25d
@libar-docs-product-area:DataAPI
@libar-docs-effort:3d
Expand Down Expand Up @@ -31,17 +32,23 @@ Feature: Data API Platform Integration - MCP Server and Monorepo Support
| Cross-package views | Understand monorepo-wide dependencies |
| Package-scoped queries | Focus on specific packages |

**Superseded:** This spec has been split into focused specs:
- MCPServerIntegration (Phase 46) -- MCP server mode (Rule 1)
- MonorepoSupport (Phase 100) -- Cross-package queries (Rule 3)
- Rule 2 (CLAUDE.md context layer) absorbed into existing ClaudeModuleGeneration
- Rule 4 (git hooks/watch) partially exists in lint-process, watch mode deferred

Background: Deliverables
Given the following deliverables:
| Deliverable | Status | Location | Tests | Test Type |
| MCP server entry point | pending | src/mcp/server.ts | Yes | integration |
| MCP tool definitions | pending | src/mcp/tools.ts | Yes | unit |
| MCP session state management | pending | src/mcp/session.ts | Yes | unit |
| CLAUDE.md context layer generator | pending | src/generators/claude-md-generator.ts | Yes | unit |
| Cross-package dependency analyzer | pending | src/api/cross-package.ts | Yes | unit |
| Package-scoped filter flag | pending | src/cli/process-api.ts | Yes | integration |
| Multi-package config support | pending | src/config/multi-package.ts | Yes | unit |
| Per-package coverage report | pending | src/api/coverage-analyzer.ts | Yes | unit |
| MCP server entry point | superseded | src/mcp/server.ts | Yes | integration |
| MCP tool definitions | superseded | src/mcp/tools.ts | Yes | unit |
| MCP session state management | superseded | src/mcp/session.ts | Yes | unit |
| CLAUDE.md context layer generator | superseded | src/generators/claude-md-generator.ts | Yes | unit |
| Cross-package dependency analyzer | superseded | src/api/cross-package.ts | Yes | unit |
| Package-scoped filter flag | superseded | src/cli/process-api.ts | Yes | integration |
| Multi-package config support | superseded | src/config/multi-package.ts | Yes | unit |
| Per-package coverage report | superseded | src/api/coverage-analyzer.ts | Yes | unit |

# ============================================================================
# RULE 1: MCP Server Mode
Expand Down
11 changes: 6 additions & 5 deletions delivery-process/specs/docs-consolidation-strategy.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
@libar-docs
@libar-docs-pattern:DocsConsolidationStrategy
@libar-docs-status:roadmap
@libar-docs-status:completed
@libar-docs-unlock-reason:Retroactive-completion
@libar-docs-phase:35
@libar-docs-effort:4w
@libar-docs-product-area:Generation
Expand Down Expand Up @@ -50,14 +51,14 @@ Feature: Documentation Consolidation Strategy
Given the following deliverables:
| Deliverable | Status | Location | Tests | Test Type |
| Preamble capability on ReferenceDocConfig | complete | src/renderable/codecs/reference.ts | Yes | unit |
| Phase 1 - Taxonomy consolidation | pending | docs/TAXONOMY.md | No | n/a |
| Phase 1 - Taxonomy consolidation | complete | docs/TAXONOMY.md | No | n/a |
| Phase 2 - Codec listings extraction | complete | delivery-process.config.ts, src/renderable/codecs/*.ts | Yes | integration |
| Phase 3 - Process Guard consolidation | complete | src/renderable/codecs/validation-rules.ts | Yes | integration |
| Phase 4 - Architecture decomposition | complete | docs/ARCHITECTURE.md | Yes | integration |
| Phase 5 - Guide trimming | pending | docs/ANNOTATION-GUIDE.md, docs/CONFIGURATION.md | No | n/a |
| Phase 6 - Index navigation update | pending | docs-live/INDEX.md, docs/INDEX.md | No | n/a |
| Phase 5 - Guide trimming | complete | docs/ANNOTATION-GUIDE.md, docs/CONFIGURATION.md | No | n/a |
| Phase 6 - Index navigation update | complete | docs-live/INDEX.md, docs/INDEX.md | No | n/a |
| Phase 37 - docs-live/ directory consolidation | complete | delivery-process.config.ts | Yes | integration |
| Phase 38 - Generated doc quality improvements | pending | src/renderable/codecs/reference.ts | Yes | integration |
| Phase 38 - Generated doc quality improvements | complete | src/renderable/codecs/reference.ts | Yes | integration |
| Phase 39 - Session workflow CLAUDE.md module generation | complete | delivery-process/specs/, _claude-md/workflow/ | No | n/a |
| Phase 40 - PUBLISHING.md relocation to MAINTAINERS.md | complete | docs/PUBLISHING.md | No | n/a |
| Phase 41 - GHERKIN-PATTERNS.md restructure | complete | docs/GHERKIN-PATTERNS.md, docs/VALIDATION.md | No | n/a |
Expand Down
Loading
Loading