← ClaudeAtlas

aiw-north-starlisted

Structured process for authoring and updating `north-star.md`, the shortest statement of what a project is trying to achieve. Use this skill when the human asks to create, scaffold, revise, or check the north-star, with phrasings like 'what is this project for', 'set up a north-star', or 'is that still the goal'. Use it also, and without being asked, when a request that has just arrived would take the project away from its stated goal, before any planning happens: that conflict means either the request is wrong or the goal has moved, and neither is the agent's call. The skill exists because a project's direction is the one thing no oracle can derive: the codebase shows what is, the spec shows what is asked, and neither says what the project is trying to achieve.
philippe-ths/ai-coding-workflow · ★ 0 · AI & Automation · score 66
Install: claude install-skill philippe-ths/ai-coding-workflow
# North Star Read this file before creating or editing `north-star.md`, and when a request pulls against what it says. ## Why This Skill Exists The workflow knows what the system does, because the codebase says so. It knows what the system should do, because the spec says so. Nothing says what the project is trying to achieve, so every judgement turning on the project's direction is resolved by interrupting the human. ## What Goes In The goal, and nothing else. Short is the point rather than a courtesy. The ceiling is 400 tokens, and a north-star approaching it has stopped being one. This is read at the start of every task, so anything in it that does not change a decision is taken from the work. A goal that has grown into a list of everything the project does has stopped being a goal. The human is its source of truth. The agent writes the file, the same division `project-context.md` uses with the codebase, except the codebase cannot supply this one. ## Altitude Too low and it describes what the project currently does. Such a goal was read out of the codebase and can never judge it, because the codebase is what it would be judging. Too high and nothing could ever conflict with it. A goal no request could contradict decides nothing and is worth no space. The test: could a plausible feature request pull against this? If nothing could, come down until something could. ## Authoring: Interview, Confirm, Write Never write this from inference alone. The goal is why the