Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,6 @@ scripts/lighthouse/reports/
_dest/
_temp/
_tmp/
docs/projects/2509-css-migration/50-59-execution/

*.local.*
.cache
Expand Down
3 changes: 2 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,8 @@ Always read these files before making changes. They define the project's archite
| `@bin/hugo-build` | Build/deploy workflow |
| `@Rakefile` | Test workflow |
| `@test/test_helper.rb` | Writing new tests |
| `@docs/projects/2509-css-migration/css-loading-order-analysis.md` | ANY CSS changes |
| `@docs/projects/2509-css-migration/2026-07-12-css-maintainability-redesign.md` | ANY CSS changes — the approved plan + evidence rule (compiled+gzip, never raw line counts) |
| `@docs/projects/2509-css-migration/css-bundle-ownership-map.md` | ANY CSS changes — which pages a CSS file affects + FL burn-down |

---

Expand Down
1 change: 0 additions & 1 deletion docs/60.06-test-format-requirements-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -631,7 +631,6 @@ Tests automatically run via CI/CD pipeline on:
### Project-Specific Documentation
- `docs/60.03-tdd-quality-enforcement.md` - jt_site TDD practices
- `docs/visual_testing_delegation_workflows.md` - Visual testing workflows
- `docs/projects/2509-css-migration/50-59-testing/SPRINT-3-TDD-TESTING-STRATEGY.md` - Sprint 3 TDD strategy

### External Documentation
- **Minitest**: https://docs.seattlerb.org/minitest/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,10 @@ pattern), not to optimize in place.

### Success criteria

1. **FL retirement burn-down**: live FL layout files 17 → 0. Each rewritten page
deletes its FL CSS file(s) and its template's `fl-node-*` markup in the same PR.
1. **FL retirement burn-down**: live FL layout files 16 → 0 (17 at audit time;
the e93d9b85 bundle was merged away in PR #363 — see
`css-bundle-ownership-map.md` for the live list). Each rewritten page deletes
its FL CSS file(s) and its template's `fl-node-*` markup in the same PR.
2. **No obfuscated artifacts** at end state: zero hash-named CSS files
(`bf72bba…`, `e966db44…`, `fb2624…`), zero generated node-id rules.
3. **No duplication in the hand-maintained layer**: new CSS uses tokens from
Expand Down Expand Up @@ -126,7 +128,7 @@ sooner; the protocol never changes.
- Old Phase 3 (pattern consolidation + Hugo enhancements, 20–45 h) is **closed as
superseded** — its premise died with the compiled+gzip evidence.
- TASK-TRACKER updates: GOAL OVERVIEW rewritten to this goal; stale CUMULATIVE
METRICS replaced by the FL burn-down table (17 → 0); new phases = Phase 0
METRICS replaced by the FL burn-down table (16 → 0); new phases = Phase 0
(scaffolding) then rewrite sprints R1…Rn.
- Pace: one page per sprint, no fixed calendar. One branch + one bundled PR per
sprint, per repo policy.
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Superseded 2026-07-12

Everything in this folder encodes the original Oct-2025 plan — "eliminate 70-80%
CSS duplication (27,094–31,536 lines)" via shared-foundation extraction and
consolidation — which was falsified on compiled+gzip evidence during Phase 1
(WP1.2/WP1.4) and the Phase 2 audits (sprint 7, 2026-07-12): PurgeCSS runs per
bundle, so each page already ships only its own FL subset, and any shared
foundation is net-negative on first-visit transfer size. The `.fl-visible`
duplication claim measured 41.9%, not 90-95%; the "7 FL layout files" count was
actually 17 (16 after the e93d9b85 bundle merge).

Kept for history only. The current authority is
`../../2026-07-12-css-maintainability-redesign.md` (strangler rewrite plan) and
`../../TASK-TRACKER.md`.
Loading
Loading