Development
Skill
/nw-buddy-project-reading
How the nWave buddy agent reads a project to answer questions — detection, order of inspection, and citation discipline.
Claude Code
$ npx -y skills add nWave-ai/nWave --skill nw-buddy-project-reading --agent claude-code
Codex
$ npx skills add nWave-ai/nWave --skill nw-buddy-project-reading -a codex -y
Cursor
$ npx skills add nWave-ai/nWave --skill nw-buddy-project-reading -a cursor -y
Gemini CLI
$ npx skills add nWave-ai/nWave --skill nw-buddy-project-reading -a gemini-cli -y
GitHub Copilot
$ npx skills add nWave-ai/nWave --skill nw-buddy-project-reading -a github-copilot -y
OpenCode
$ npx skills add nWave-ai/nWave --skill nw-buddy-project-reading -a opencode -y
Windsurf
$ npx skills add nWave-ai/nWave --skill nw-buddy-project-reading -a windsurf -y
SKILL.md
nw-buddy-project-reading.SKILL.mdname: nw-buddy-project-reading description: Evidence-first project reading protocol based on durable authorities, Git, tests, and installed surfaces.
Project Reading for the Buddy Agent
Answer from current evidence and cite repository-relative paths and lines.
Cheap-to-expensive order
1. Read project instructions and the user's named artifact. 2. Read durable product authorities for jobs, journeys, vision and KPI meaning. 3. Read durable design authorities and ADRs for boundaries and decisions. 4. Read Request-derived execution facts only through the resident software when they are necessary. 5. Read the oracle, source and tests only when the question requires them. 6. Use `code-fact` for structural facts and degrade LOUD when approximate. 7. Use Git and terminal command evidence for completion; use an installed runtime probe for distribution claims.
Do not infer progress from a directory, markdown status, model narration or process exit alone. A delivery is complete only when the resident runner reports its terminal result after applicable review, source-blind EXAMINE and finalization.
When evidence conflicts, name the owning authority and the first falsifier. Never reconstruct state from a retired feature artifact or workflow mode.
Stats
634
Stars
67
Forks
Active
Maintenance
Python
Language
MIT
License
Last commit
Created
Ships withnwave
AI agents that guide you from idea to working code, with human judgment at every gate. nWave runs inside Claude Code. It breaks feature delivery into seven waves (discover, diverge, discuss, design, devops, distill, deliver).
628151 skills34 agents
Stars on GitHub
Momentum
- stars in total
- 628
Other skills on nwave.
More skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about nw-buddy-project-reading.
- Which coding agents can use nw-buddy-project-reading?
- nw-buddy-project-reading installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.