atomic-report
Skill6 starsChanged 48 days agoMITView on GitHub
Read-only atomic bullet-point status snapshot: what landed in the last 24h, every open/in-progress ticket, the next eligible tickets in the queue, and every open branch/worktree. Use for /atomic-report or a quick daily status check — terser than dev-report, scanned in ten seconds.
In this repository24 other files it gives its agents.
- docs/AGENTS.mdAGENTS.md
- board-validateSkill
- data-modelSkill
- delivery-hygieneSkill
- dev-reportSkill
- dev-setupSkill
- frontend-qualitySkill
- gcSkill
- git-branchSkill
- land-and-archiveSkill
- orchestration-healthSkill
- orchestratorSkill
- pipeline-qualitySkill
- plan-updateSkill
- project-planSkill
- release-gateSkill
- repo-auditSkill
- scaleSkill
- security-reviewSkill
- swarmSkill
- test-coverageSkill
- tpmSkill
- trackerSkill
- worktree-cleanupSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 31
If nothing landed in the last 24h, say so plainly — don't pad the section with older commits.
- Distinctive: line 85
Check first — a project with no plan has nothing to file against:
- Distinctive: line 91
If a plan exists, file each uncovered finding once:
- Very specific: line 119
Read-only, except the plan's gap inbox: No edits to source, no git writes, no commits, and no board writes.
- Distinctive: line 120
One fact per bullet: If a line needs "and", split it into two bullets.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Atomic Report
A one-line-per-fact status snapshot scoped to right now: what happened recently, what's open, what's next, and what git state is lying around. Every bullet must trace back to a git or board command — no narrative, no synthesis, no speculation.
This is not dev-report — dev-report is the full narrative status, correlated against the
board section by section. This is the terse, disposable version. Don't reproduce
dev-report's full correlation logic here; if the user wants that depth, point them at
/dev-report instead of expanding this one.
Before reporting
Fetch first — same discipline as gc: git fetch --all --prune. A stale checkout inverts
every bucket below. If the fetch fails (no remote, offline), say "fetch failed — report may be
stale" and continue rather than guessing.
1. Last 24 hours
git log --oneline --since="24 hours ago" --all on the repo, plus any ticket worktrees
(git worktree list, under ../.maestro-wt/* if present). One bullet per commit: sha,
subject, branch. Where a commit sha matches a {{BOARD}}/archive.json entry, collapse that
ticket's whole commit sequence into a single "landed" bullet (T-0NN landed — <name>) instead
of listing each commit separately.
If nothing landed in the last 24h, say so plainly — don't pad the section with older commits.
2. Open / in-progress
From {{BOARD}}/data.json: every ticket with an in-progress/claimed status, one bullet each —
id, name, and its evidence (branch/worktree if one exists, or "claimed, no branch" if not —
the same "claimed but empty" finding dev-report flags; flag it the same way here).
3. Next up
From {{BOARD}}/data.json: backlog tickets whose depends_on are all satisfied (landed, or in
archive.json) — the next eligible tickets in board order, capped at 5. One bullet each: id,
name, priority. If nothing is eligible, say so and name the blocker (e.g. "all backlog blocked
on T-0NN").
4. Branches & worktrees
git worktree list— one bullet per worktree: path, branch, ticket id if the branch name encodes one.git branch -a --no-merged origin/<default>— one bullet per unmerged branch not already covered above.- Flag anything merged-but-not-deleted as a candidate for
worktree-cleanup.
Output
Flat bullets under the four headers above, nothing else — no summary paragraph, no
recommendations beyond naming the skill that would act on a finding (worktree-cleanup,
orchestration-health, gc). If a section is empty, write "none" — don't omit the header.
# Atomic Report
## Last 24h
- <sha> <subject> (<branch>)
- T-0NN landed — <name>
- none
## Open / in-progress
- T-0NN <name> — <branch or "claimed, no branch">
## Next up
- T-0NN <name> (<priority>)
## Branches & worktrees
- <path> → <branch> (T-0NN)
- <branch> — unmerged, no worktreeFile what's missing as a plan gap
A finding that the project plan doesn't cover belongs in the plan, not only in this report. A report is read once; a gap sits against the plan, holds its completeness percentage down, and has to be answered.
Check first — a project with no plan has nothing to file against:
maestro plan status --board {{BOARD}}/data.jsonIf a plan exists, file each uncovered finding once:
maestro plan gap-add --board {{BOARD}}/data.json --from "atomic-report" \
--need required --text "<what the plan is missing, stated as a gap>"--need required— the plan is genuinely incomplete without it: an unstated requirement the project clearly depends on, a quality bar the work is already being judged against, a deliverable nobody wrote down. These lower the percentage until a human accepts or declines them.--need optional— worth considering. Never affects the percentage.
Rules that keep this from becoming noise:
- State the gap, not the fix. "No stated availability target for the API" — not "add a health check".
- Only what the plan is missing. A bug, a stale branch, or a failing test is a report finding and belongs in the report. It is not a plan gap.
- Be sparing with
required. Classify as required only what you could defend to the owner. A wall of required gaps reads as noise and gets ignored wholesale. - Re-runs are safe: a gap whose text already exists is skipped, not duplicated.
Name every gap you filed in your summary, with its id and need. Triage happens in
/plan-update, never here — you file, a human decides.
Rules
- Read-only, except the plan's gap inbox. No edits to source, no git writes, no commits, and no board writes.
maestro plan gap-addis the one exception: it files a question against the plan for a human to answer, and commits the project to nothing. - One fact per bullet. If a line needs "and", split it into two bullets.
- Unknown beats guessed. A failed git command is reported as unknown, not silently skipped or omitted.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

