Files

vitya 27465089b5 promote: workshop/board-viewer brainstorm → concepts + 5 tasks

- concepts/board-viewer.md (design, promoted from .workshop)
- .tasks/STATUS.md + 5 per-task files:
  - board-viewer-pointers (pre-impl, status=ready)
  - board-viewer-gitea-reader (impl, TDD, status=ready)
  - board-viewer-html-render (impl, TDD, blocker=gitea-reader)
  - board-viewer-cron-deploy (impl, infra carve-out, blocker=html-render)
  - board-viewer-review (umbrella, status=blocked)

TDD-mode embedded in impl-tasks per follow tdd-criteria trigger in CLAUDE.md.
MCP write-side workaround per memory reference_projects_meta_resolveTarget_bug.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-22 08:21:59 +03:00

3.4 KiB

Raw Blame History

board-viewer-pointers

Goal

Pre-impl bootstrap: заполнить .wiki/CLAUDE.md секцию «Domain conventions» pointer-блоком на спецификацию. Дизайн не лежит в этом репо целиком — только pointer-stub. Без этой таски следующий агент попадёт в дыру: dense where_stopped one-liner + пустой Domain conventions stub = угадывание архитектуры вместо чтения готовых решений.

Кто делает: любой следующий агент в этом проекте. Это первая по приоритету таска промоушена — все импл-таски ссылаются на pointers через .wiki/CLAUDE.md.

Key files

.wiki/CLAUDE.md — Domain conventions section
.wiki/concepts/board-viewer.md — canonical design (target of pointer)
~/projects/.workshop/.archive/2026-05-22-board-viewer.md — brainstorm rationale (target of pointer)

Acceptance criteria

.wiki/CLAUDE.md содержит блок «Mandatory: read design context before implementation» в Domain conventions (см. Next action ниже — дословный текст).
Коммит с message wiki(claude): add design-context pointers for board-viewer.
Push в origin/master.

Next action (готовый блок для копирования в `.wiki/CLAUDE.md` Domain conventions)

Заменить существующий комментарий-stub в секции ## Domain conventions на следующий блок:

### Mandatory: read design context before implementation

Before picking up any task in `.tasks/`, load the full design context. It does **not** live in this repo fully — only pointers do. Sources, in order:

1. **Canonical design:** `.wiki/concepts/board-viewer.md`. Architecture decisions, scope, MVP feature list, anti-patterns (hermes-style, Gitea Projects), trade-offs.
2. **Brainstorm process trace (rationale):** `~/projects/.workshop/.archive/2026-05-22-board-viewer.md`. Why each decision was made, what was rejected and why, clarifying note that `mcp__projects-meta__*` is not callable from HTTP service.
3. **Local `overview.md`** — quick orientation summary; never source of truth.

Do **not** invent thresholds, taxonomies, container topology, or pipeline stages from task `where_stopped` lines alone — those are pointers, not specifications.

### TDD posture

Per `follow tdd-criteria` trigger in this CLAUDE.md: impl-tasks `board-viewer-gitea-reader` and `board-viewer-html-render` are TDD. `board-viewer-cron-deploy` falls under the infrastructure carve-out (declarative systemd / traefik / DNS — verify by deploy + curl, not unit tests). Mark each impl commit accordingly.

После вставки: коммит, push.

Decisions log

2026-05-22: pointers task создан промоушеном из .workshop/.brainstorm/board-viewer.md (workshop-promote-brainstorm).

Open questions

(нет — pointer-блок самодостаточен)

Completed steps

(фиксируется при выполнении)

Notes

Pointer-таска намеренно тривиальная — её существование защищает следующего агента от чтения stub'а вместо спецификации. Не объединять с импл-тасками.

3.4 KiB Raw Blame History Unescape Escape