Compare commits
2 Commits
bb113c6cfb
...
eab171308e
| Author | SHA1 | Date | |
|---|---|---|---|
| eab171308e | |||
| bff9c622c2 |
@@ -477,4 +477,17 @@ needs-claude
|
|||||||
<!-- created-by: vitya@DESKTOP-NSEF0UK / from: sovereign-catalog-wave2-review / 2026-08-12 -->
|
<!-- created-by: vitya@DESKTOP-NSEF0UK / from: sovereign-catalog-wave2-review / 2026-08-12 -->
|
||||||
<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / workshop — trigger dropped, triggers verified against installed skills -->
|
<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / workshop — trigger dropped, triggers verified against installed skills -->
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🟢 [using-tasks-archive-path-fix] — `skills/using-tasks/SKILL.md` документирует `.tasks/archive/YYYY-MM.md`, реальная конвенция репо — `.tasks/.archive/done-YYYY-MM.md` (см. `done-2026-05.md`, `done-2026-08.md`). Найдено: sovereign-catalog-wave2-review (finding, передано воркшопу 13:43Z).
|
||||||
|
|
||||||
|
**Status:** done
|
||||||
|
**Where I stopped:** done — SKILL.md v1.4.0→v1.4.1 (PATCH): 5 путей исправлены (layout → `.archive/done-YYYY-MM.md`, intro, «Where» + commit-пример + Rules-буллет → `.tasks/.archive/done-YYYY-MM.md`), README чист. dist пересобран (build.ps1 -Names using-tasks), lint 39/0. Фикс: `bff9c62`.
|
||||||
|
**Next action:** (none — done)
|
||||||
|
**Branch:** master
|
||||||
|
**Weight:** cheap-ok
|
||||||
|
**Notify:** OpeItcLoc03/workshop
|
||||||
|
<!-- created-by: workshop session (from: sovereign-catalog-wave2-review finding) / 2026-08-12 -->
|
||||||
|
<!-- closed-by: vitya@DESKTOP-NSEF0UK / 2026-08-12 / workshop — archive path fixed in using-tasks v1.4.1, dist rebuilt -->
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
BIN
dist/using-tasks.skill
vendored
BIN
dist/using-tasks.skill
vendored
Binary file not shown.
@@ -1,7 +1,7 @@
|
|||||||
---
|
---
|
||||||
name: using-tasks
|
name: using-tasks
|
||||||
author: ours
|
author: ours
|
||||||
version: 1.4.0
|
version: 1.4.1
|
||||||
description: >
|
description: >
|
||||||
Policy skill for working with an existing `.tasks/` board (per-task files + STATUS.md).
|
Policy skill for working with an existing `.tasks/` board (per-task files + STATUS.md).
|
||||||
Use whenever the user is switching between tasks, resuming a paused task, starting a new
|
Use whenever the user is switching between tasks, resuming a paused task, starting a new
|
||||||
@@ -37,13 +37,13 @@ If `.tasks/` is **missing**, or `STATUS.md` exists but is non-canonical (e.g. fl
|
|||||||
STATUS.md ← active board: 🔴 / 🟡 / ⚪ / 🔵 blocks, sorted by priority
|
STATUS.md ← active board: 🔴 / 🟡 / ⚪ / 🔵 blocks, sorted by priority
|
||||||
<task-slug>.md ← deep context per task, one file each
|
<task-slug>.md ← deep context per task, one file each
|
||||||
.lock ← runtime session lock; **gitignored** (never committed)
|
.lock ← runtime session lock; **gitignored** (never committed)
|
||||||
archive/
|
.archive/
|
||||||
YYYY-MM.md ← 🟢 done blocks moved off the board, one file per month
|
done-YYYY-MM.md ← 🟢 done blocks moved off the board, one file per month
|
||||||
```
|
```
|
||||||
|
|
||||||
Commit `.tasks/` to git. Decision history is valuable; diffs show how thinking evolved.
|
Commit `.tasks/` to git. Decision history is valuable; diffs show how thinking evolved.
|
||||||
|
|
||||||
`STATUS.md` is the **active** board — it must stay lean so orientation reads stay cheap. Closed 🟢 tasks are archived to `archive/YYYY-MM.md` once they pile up; see "### Archiving done tasks".
|
`STATUS.md` is the **active** board — it must stay lean so orientation reads stay cheap. Closed 🟢 tasks are archived to `.archive/done-YYYY-MM.md` once they pile up; see "### Archiving done tasks".
|
||||||
|
|
||||||
> **`.tasks/.lock` must be listed in `.gitignore`** (add `.tasks/.lock` to your project's `.gitignore`). The lock file is ephemeral runtime state, not project history — it must never be committed.
|
> **`.tasks/.lock` must be listed in `.gitignore`** (add `.tasks/.lock` to your project's `.gitignore`). The lock file is ephemeral runtime state, not project history — it must never be committed.
|
||||||
|
|
||||||
@@ -186,7 +186,7 @@ Temporary hypotheses, links, names of people to consult.
|
|||||||
|
|
||||||
**Threshold.** When `STATUS.md` holds **≥ 10** 🟢 done blocks, archive them. Check at two moments: (a) right after closing a task (Task completion step 7), and (b) at session start, before orienting (Session start step 7). The threshold is a ceiling, not a target — archive in batches; don't churn one block at a time.
|
**Threshold.** When `STATUS.md` holds **≥ 10** 🟢 done blocks, archive them. Check at two moments: (a) right after closing a task (Task completion step 7), and (b) at session start, before orienting (Session start step 7). The threshold is a ceiling, not a target — archive in batches; don't churn one block at a time.
|
||||||
|
|
||||||
**Where.** Append the archived blocks to `.tasks/archive/YYYY-MM.md` — one file per calendar month, keyed by the date of archival. Create `.tasks/archive/` and the month file if absent. If the month file already exists, **append**; never overwrite.
|
**Where.** Append the archived blocks to `.tasks/.archive/done-YYYY-MM.md` — one file per calendar month, keyed by the date of archival. Create `.tasks/.archive/` and the month file if absent. If the month file already exists, **append**; never overwrite.
|
||||||
|
|
||||||
**Archive file format** (header written once, on file creation):
|
**Archive file format** (header written once, on file creation):
|
||||||
|
|
||||||
@@ -204,7 +204,7 @@ Full source is git history; this file is for grep-able historical context.
|
|||||||
**After archiving,** `STATUS.md` keeps only 🔴 / 🟡 / ⚪ / 🔵 blocks. Commit the move on its own:
|
**After archiving,** `STATUS.md` keeps only 🔴 / 🟡 / ⚪ / 🔵 blocks. Commit the move on its own:
|
||||||
|
|
||||||
```
|
```
|
||||||
git add .tasks/ && git commit -m "meta(tasks): archive done batch → .tasks/archive/YYYY-MM.md"
|
git add .tasks/ && git commit -m "meta(tasks): archive done batch → .tasks/.archive/done-YYYY-MM.md"
|
||||||
```
|
```
|
||||||
|
|
||||||
Leave a just-closed 🟢 block on the board only while it's still useful at a glance (pending merge, fresh reference). Everything older goes to the archive.
|
Leave a just-closed 🟢 block on the board only while it's still useful at a glance (pending merge, fresh reference). Everything older goes to the archive.
|
||||||
@@ -246,7 +246,7 @@ Pair: `using-projects-meta` declares local-first for **reads**; this rule extend
|
|||||||
- **Commit after every session end** — git log is the history of thinking.
|
- **Commit after every session end** — git log is the history of thinking.
|
||||||
- **Always confirm orientation at session start** — state understanding before acting.
|
- **Always confirm orientation at session start** — state understanding before acting.
|
||||||
- **One active task at a time** — only one 🔴 in STATUS.md.
|
- **One active task at a time** — only one 🔴 in STATUS.md.
|
||||||
- **Keep the board lean** — orientation reads the local `STATUS.md` whole, so archive 🟢 done blocks to `.tasks/archive/YYYY-MM.md` once ≥10 pile up. Never enumerate the current project's board via `tasks_aggregate` (cross-project cache) or `tasks_get_status` (single-task, by slug). See "### Archiving done tasks".
|
- **Keep the board lean** — orientation reads the local `STATUS.md` whole, so archive 🟢 done blocks to `.tasks/.archive/done-YYYY-MM.md` once ≥10 pile up. Never enumerate the current project's board via `tasks_aggregate` (cross-project cache) or `tasks_get_status` (single-task, by slug). See "### Archiving done tasks".
|
||||||
- **Never close a task without a coverage check** — see "### Task completion" step 1. Acceptance criteria with no evidence → ask, don't auto-close.
|
- **Never close a task without a coverage check** — see "### Task completion" step 1. Acceptance criteria with no evidence → ask, don't auto-close.
|
||||||
- **Honour `session_break`** — a closed task carrying a `session_break` marker means stop after close; never chain into `tasks_claim_next`. See "### Task completion" step 6.
|
- **Honour `session_break`** — a closed task carrying a `session_break` marker means stop after close; never chain into `tasks_claim_next`. See "### Task completion" step 6.
|
||||||
- **Local-first recommendations** — cwd-project board comes first; cross-project urgents are at most one footnote line.
|
- **Local-first recommendations** — cwd-project board comes first; cross-project urgents are at most one footnote line.
|
||||||
|
|||||||
Reference in New Issue
Block a user