Marcos Paulo
aae4d42229
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>
50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# 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
|