os-big-picture

Featured

ALWAYS invoke this skill when the user asks where the project as a whole stands - "where are we", "what's the big picture", "what have we built", "what is in this project", "map the project", "what does this thing even do", "what is stale", "what can we delete", "update the roadmap" - in any language, and whenever a session report has just been written. It keeps one file, BIG-PICTURE.md: what the product is, every feature with how far it got, which parts nobody has touched, and what is queued next. Age and wiring are measured from git; how far a feature got comes from the reports or says "not checked". Where a tracker is connected it offers to open the queue as tickets, after a yes and never before. Never invents work, never deletes code.

AI & Automation 948 stars 91 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%
99
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# os-big-picture One file, `BIG-PICTURE.md`, where `os-whats-next` already looks for a backlog. It answers "where are we now" - not a plan, nothing in it a promise. Write it in the user's language; paths stay English. **When to use it.** The user asks where the project stands, or there is no `BIG-PICTURE.md` yet → the full pass: describe, census, signals, backlog. A session report was just written → the fold-in: only the rows that session touched. Both re-measure, because a session that moves no row is the one after which the dates go quietly stale. ## Step 1 - find the file, and never clobber it `BIG-PICTURE.md` in the project root, and it may already be somebody's own work. Everything this skill writes lives between `<!-- open-steps:begin -->` and `<!-- open-steps:end -->`; no markers → append at the end; no file → create it, and add it to this clone's ignore list, never to `.gitignore`: ```bash f=BIG-PICTURE.md; e="$(git rev-parse --git-dir)/info/exclude" git check-ignore -q "$f" || git ls-files --error-unmatch "$f" >/dev/null 2>&1 \ || grep -qxF "$f" "$e" 2>/dev/null || printf '%s\n' "$f" >> "$e" ``` Each of the three is a reason to leave it alone. Say in one line that you did it; `git add -f BIG-PICTURE.md` shares it instead. Never read `Last worked on` or `Signal` back out of the file - only `Stage` and the queue carry forward. ## Step 2 - the census, measured by the script ```bash bash "${CLAUDE_SKILL_DIR}/scripts/census.sh" . ``` An `AGE` line, then one mea...

Details

Author
kharmanskyi
Repository
kharmanskyi/open-steps
Created
1 months ago
Last Updated
1 weeks ago
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

os-whats-next

ALWAYS invoke this skill when the user asks what to do next, what is left, or what is blocked - "what's next", "what now", "what should we work on", "anything I can do" - in any language. This skill picks the next piece of work; when the user asks HOW to do a thing or says they do not understand what to do, that is os-step-by-step. Reads the last report, local changes, open pull requests and always the backlog. First finishes what is finished: verified-ready pull requests merge in the same pass. Then sorts the rest into doable-alone and needs-you, ending with one recommended next task in plain words - what it closes or unblocks. Never invents tasks.

948 Updated 1 weeks ago
kharmanskyi
AI & Automation Listed

session-status

This skill should be used when the user asks "what's up", "where are we", "catch me up", "what's the status", "what's left", "what should I do next", "remind me what we were doing", or runs /whats-up. Also applies when resuming a session after a break or a context compaction, before handing work to someone else, or when the user sounds lost about the current state. Briefs the user on where work stands — progress, in-flight work, remaining tasks, the single next step, blockers and suggested follow-ups.

0 Updated 3 days ago
pyang2045
AI & Automation Listed

roadmap

Use when the user asks what to work on next, wants to start the next thing, adds or tracks a feature, page, function or integration, initializes a project, asks what is left to build, wants work batched into parallel waves or phases, wants competing items prioritized or ranked, or the roadmap needs reconciling against reality.

0 Updated 1 weeks ago
RubyEyedReaper