ba33f8cf27
closes board-viewer-pointers Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
59 lines
3.6 KiB
Markdown
59 lines
3.6 KiB
Markdown
# 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` на следующий блок:
|
||
|
||
```markdown
|
||
### 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).
|
||
- 2026-05-22: pointer-блок вставлен в `.wiki/CLAUDE.md` Domain conventions дословно из Next action; closed.
|
||
|
||
## Open questions
|
||
|
||
- [ ] (нет — pointer-блок самодостаточен)
|
||
|
||
## Completed steps
|
||
|
||
- [x] вставлен блок «Mandatory: read design context before implementation» + «TDD posture» в `.wiki/CLAUDE.md`
|
||
|
||
## Notes
|
||
|
||
Pointer-таска намеренно тривиальная — её существование защищает следующего агента от чтения stub'а вместо спецификации. Не объединять с импл-тасками.
|