88 lines
3.5 KiB
Markdown
88 lines
3.5 KiB
Markdown
# Architecture Quality Backlog Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** publish a canonical architecture backlog in `docs/` and reconcile roadmap/audit statuses without changing runtime code.
|
|
|
|
**Architecture:** this feature is a documentation workflow. We inventory the already completed architecture work, collapse stale and duplicated backlog entries, and publish one normalized backlog that future features can implement independently.
|
|
|
|
**Tech Stack:** Markdown docs in `docs/`, Docusaurus-published architecture pages in `apps/docs/docs/`, repository search and patch tooling.
|
|
|
|
---
|
|
|
|
### Task 1: Promote canonical feature docs
|
|
|
|
**Files:**
|
|
- Create: `docs/features/architecture-quality-backlog/spec.md`
|
|
- Create: `docs/features/architecture-quality-backlog/plan.md`
|
|
- Create: `docs/features/architecture-quality-backlog/tasks.md`
|
|
|
|
- [x] **Step 1: Move the worktree draft into canonical docs**
|
|
|
|
Create the feature directory in the main workspace and copy the prepared `spec/plan/tasks` structure.
|
|
|
|
- [x] **Step 2: Rewrite the feature around the actual output**
|
|
|
|
Describe the feature as completed docs-only normalization work rather than an unexecuted draft.
|
|
|
|
- [x] **Step 3: Publish the normalized backlog**
|
|
|
|
Keep one ordered backlog with explicit risks, dependencies, and future feature boundaries.
|
|
|
|
### Task 2: Reconcile related source-of-truth docs
|
|
|
|
**Files:**
|
|
- Modify: `docs/features/frontend-debt-audit/spec.md`
|
|
- Modify: `docs/features/backend-architecture-refactor/spec.md`
|
|
|
|
- [x] **Step 1: Remove stale already-closed debt notes**
|
|
|
|
Reclassify items already covered by `api-envelope-contract` and `backend-architecture-refactor`.
|
|
|
|
- [x] **Step 2: Point remaining open debt at the canonical backlog**
|
|
|
|
Avoid competing backlog lists by linking residual items to `architecture-quality-backlog`.
|
|
|
|
- [x] **Step 3: Synchronize status wording**
|
|
|
|
Update `backend-architecture-refactor` from draft to completed state to match its finished tasks.
|
|
|
|
### Task 3: Publish roadmap changes
|
|
|
|
**Files:**
|
|
- Modify: `docs/roadmap.md`
|
|
|
|
- [x] **Step 1: Mark completed architecture refactor work as done**
|
|
|
|
`Backend Architecture Refactor` must no longer appear as open if the feature tasks and verification log are complete.
|
|
|
|
- [x] **Step 2: Add the new completed docs-only feature**
|
|
|
|
Record `architecture-quality-backlog` in the completed work history as the canonical backlog publication step.
|
|
|
|
- [x] **Step 3: Replace the loose candidate list with normalized tracks**
|
|
|
|
Publish the same ordered backlog from the feature spec so roadmap and feature docs match.
|
|
|
|
### Task 4: Final consistency pass
|
|
|
|
**Files:**
|
|
- Read: `docs/features/architecture-quality-backlog/spec.md`
|
|
- Read: `docs/features/architecture-quality-backlog/plan.md`
|
|
- Read: `docs/features/architecture-quality-backlog/tasks.md`
|
|
- Read: `docs/features/frontend-debt-audit/spec.md`
|
|
- Read: `docs/features/backend-architecture-refactor/spec.md`
|
|
- Read: `docs/roadmap.md`
|
|
|
|
- [x] **Step 1: Confirm docs-only scope**
|
|
|
|
Only documentation files should change.
|
|
|
|
- [x] **Step 2: Confirm consistent backlog ordering**
|
|
|
|
The five normalized directions must appear with the same meaning everywhere they are referenced.
|
|
|
|
- [x] **Step 3: Confirm no duplicate stale backlog remains**
|
|
|
|
Historical docs can keep audit context, but they should no longer compete with the canonical backlog.
|