agentleFS
samwelmungasamwelmunga/jenga-npm/.agents/skills/j-status/SKILL.md

j.status

Skill0 starsChanged 22 days agoApache-2.0View on GitHub

Print a human-readable summary of the entire scrum board — all epics, stories, and tasks with their statuses — plus any open rapports and unprocessed queue triggers. Use when you want a quick overview of project state without reading raw files.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    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
  1. Very specific:

    If no epics exist, print: No board items found.

    line 67

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Status — Board Overview

skills/j-status/ is the canonical, hand-edited directory for this skill, per CLAUDE.md's "The Canonical Naming Contract" (the E50 reopening of 2026-09-09, which promoted skills/j-status/ from generated twin to sole canonical form). The j- prefix is there for collision safety — a real directory under a distinct name, so a host tool shipping its own same-named built-in command cannot shadow it (Claude Code's native skill resolution is a literal-string, directory-name-based match; see project/documentation/skill-authoring.md's "Invocation Convention").

⚠️ scripts/generate-j-alias.sh was retired by E50_S14 and no longer exists — there is nothing to run. This file was previously generated from a bare skills/status/SKILL.md source; E50_S15 deleted that directory. This file is now the sole canonical, hand-edited source for this skill — edit it directly.

Instructions

  1. Read project/configs/workflow.json to confirm board paths. Fall back to project/board/ if the file does not exist.
  2. Scan epics — Read all files in project/board/epics/. For each epic, extract: id, title, status, date_started, date_completed, and the stories list.
  3. Scan stories — For each story referenced in the epics list, read its file from project/board/stories/. Extract: id, title, status, tasks list.
  4. Scan tasks — For each task referenced in each story, read its file from project/board/tasks/. Extract: id, title, status, assigned_to.
  5. Scan open rapports — List all .md files in project/rapports/problems/ that do not end in .IGNORE.md. List all .md files in project/rapports/analysis/.
  6. Check the queue — If project/queue/scrum_triggers.jsonl is non-empty, note the number of pending triggers awaiting the scrum master.

6.5. Run the deploy-reconcile pass (E51_S05) before printing the summary — /status has no scripts/ directory of its own comparable to /self-sync's, so invoke the shared pipeline directly rather than adding a third skill-local wrapper script:

bash "$([ -f scripts/mark-deployed.sh ] && echo scripts/mark-deployed.sh || echo node_modules/@jenga-ai/agent/scripts/mark-deployed.sh)"

This defaults to invoking its own sibling scripts/compute-deploy-reconcile.sh, which discovers any not-yet-reconciled vX.Y.Z-stage/vX.Y.Z tags on the public jenga-npm repo (unauthenticated read — no credential required) and promotes matching Publicized/ Deployed to Stage tickets to Deployed to Stage/Deployed to Prod (writing date_deployed_prod on a Prod promotion) by commit ancestry, before this skill re-scans the board in steps 2-4 above. This step is non-fatal: a failure anywhere in the pipeline (including an unreachable public repo) is logged as a warning only and never prevents /status from printing whatever board state it already has, and never causes a non-zero exit.

6.7. Check project/todo.md formatting — invoke

bash "$([ -f scripts/check-todo-format.sh ] && echo scripts/check-todo-format.sh || echo node_modules/@jenga-ai/agent/scripts/check-todo-format.sh)"

Same script /j-reconcile uses (never a second, independently-maintained check) — it reuses parsers/todo.js's own LEADING_REF_MISORDER_PATTERN so both skills and the dashboard's /v1/todo-warnings route always agree on the same set of lines. Exit 0 with no output means nothing to report — skip the warning line in step 7 entirely. A non-zero exit prints one line <N>: <text> per malformed entry — carry the count (and, per assets/output_format.md, the first couple of lines) into the summary. Report only, same as /j-reconcile: never edit project/todo.md here.

  1. Print the summary following the layout and icon conventions in assets/output_format.md.
  2. If no epics exist, print: No board items found. Run /pi-plan to define epics or /todo to add items.

Scope note: playbook step status (E53_S04_T03 audit)

This skill reports board-level status only (steps 2-4 above: epic/story/task status from project/board/). It never reads or reports /jenga playbook run state (skills/jenga/scripts/run-playbook-step.sh's temp state file, its step_ready/complete/ halted reports, or per-step passed/failed/skipped outcomes) — a playbook run is ephemeral, session-local execution state, not a board item, and has no representation in project/board/. This is confirmed as intentional, not a gap: skipped is scoped strictly to playbook-step context and is never written to a task/story's board-level status field (see templates/SCRUM_BOARD_SCHEMA.md's Status Values table, unmodified by E53_S04).

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.