Files

T

Marcos Paulo aae4d42229 docs: add .agents workspace and the Astro refactor plan

Adds the agent-facing workspace and a 20-task plan for migrating the site
to Astro. Nothing here implements the refactor; these are briefs, rules and
templates that the task agents read.

- .agents/ holds context, rules, checklists, skills, specialist agents,
  component/page/config templates and gate scripts. It is vendor-neutral so
  MiniMax, Gemini and Codex can all read it; CLAUDE.md just points at
  AGENTS.md.
- .husky/ plus .lintstagedrc.json wire the three gate tiers. gate.sh locks on
  the shared git-common-dir so parallel worktrees serialise, and guards the
  assertion count in scripts/verify.mjs against a coverage drop.
- plans/astro-refactor/ carries the phase graph, per-task briefs and the
  model-routing recommendation.

These files must be tracked before fanning out: a worktree only checks out
tracked files, so an untracked plan is invisible to every agent working in one.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-05 01:18:27 +00:00

1.7 KiB

Raw Blame History

Task 11 — Review-desk blocks

Agent: component-builder · Model: MiniMax-M3 Depends on: 07 · Parallel with: 08, 09, 10 · Blocks: 16 Worktree: .agents/scripts/worktree.sh start 11 review-blocks

Goal

Review-desk furniture as static components. Interactivity is task 16.

Scope

src/components/blocks/ — SkillList.astro, ReviewDetail.astro, FileTabs.astro, PreviewPane.astro, ChangeLens.astro, VoteWidget.astro (markup only).

Source

skills-review/index.html, app.js (20 KB), styles.css, change-lens.css, vote.js.

One component, 24 entries

The 24 reviews are data, not 24 components. One SkillReviewCard iterating the collection. If you are writing the second near-identical component, stop.

CSS tokens asserted by verify.mjs

.change-lens, .change-rows, .skill-diff, .diff-lines, .markdown-preview, max-height:540px, .markdown-table-wrap, .markdown-frontmatter, .markdown-toc, .preview-title, .preview-markdown, grid-template-columns:minmax(0,1fr), height:120px, -webkit-line-clamp:2, .vote-widget, .vote-buttons, [aria-pressed="true"].

Class names may move into scoped <style> blocks, but each must still exist and task 19 must be able to assert it. Coordinate names with the verification engineer rather than renaming freely.

Watch for

aria-pressed on the vote buttons and preview switcher is how state reaches assistive tech. Colour alone is not enough. It is also asserted.

Done when

All listed CSS hooks present
aria-pressed, role="group", aria-label preserved
Static render matches current desk at four widths
Checklist complete; npm run gate green

1.7 KiB Raw Blame History