understand-project-yylo – Coding skill for AI agents
Inspect the current product architecture, dependencies, and validation loops before planning or implementing a requested change.
Install the understand-project-yylo skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/understand-project-yylo-3778b.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /understand-project-yylo – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/understand-project-yylo-3778b.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $understand-project-yylo – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/understand-project-yylo-3778b.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /understand-project-yylo – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/understand-project-yylo-3778b.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /understand-project-yylo – then describe the task you want done.
SKILL.md content
Understand the project
1. Read AGENTS.md/CLAUDE.md, repository status, relevant source, tests, and existing product documentation in the integration or assigned feature worktree.
2. Read related Kanban tasks and durable specs through the canonical metadata controller. Do not assume .juno_task/plan.md exists and do not materialize controller-private metadata in a product worktree.
3. Trace only the dependencies and runtime paths needed for the requested goal. Use bounded parallel investigation when independent questions justify it.
4. Report current behavior, sources of truth, affected components, risks, unknowns, and the smallest useful validation loop.
5. If the user requested planning, hand the findings to plan-ledger-tasks-yylo. If implementation was requested, work only in the task worktree returned by yy task start TASK_ID.
6. Write a durable operational spec only when requested or materially useful. Draft it externally, preflight the installed yy ledger artifact API, capture it as an immutable report Artifact Record with provenance/retention, and verify retrieval, digest, and history. If that API is unavailable, stop with the external draft intact; never fall back to product docs/, task bodies/responses, new .juno_task/specs, or direct controller-store edits. Product docs/ remains reserved for documentation shipped with the product. Do not update root instructions with transient status.
Invocation contract
The structured views below intentionally alias parts of the complete request; they are not additional user arguments.
Main task
$1
Constraints and context
$2
Complete raw request
$ARGUMENTS
When to Use
- Before planning or implementing a requested change, when you need current architecture, dependencies, and validation loops.
- To hand grounded findings to
plan-ledger-tasks-yylo(planning) or a task worktree (implementation).
Limitations
- Read-only: reports current behavior, sources of truth, affected components, risks, unknowns, and the smallest validation loop - does not implement.
- Bounded investigation only; do not materialize controller-private metadata in a product worktree.
- Durable specs are captured as immutable Artifact Records only when the installed
yy ledger artifactAPI supports it; otherwise stop with the external draft intact.
Example
yy ledger search --status todo --limit 5
yy ledger get TASK_ID> Adapted from [yylo-dev/yylo-skills](https://github.com/yylo-dev/yylo-skills) (MIT) - v2.0.1; frontmatter, When to Use/Limitations, and safety boundaries added for upstream compliance.
Related skills
- unit-testing-test-generate – Generate comprehensive, maintainable unit tests across languages with strong coverage…
- unity-developer – Build Unity games with optimized C# scripts, efficient rendering, and proper asset…
- unslop-review – Rewrites code review comments so they read like a human teammate wrote them. Cuts…
- upgrading-expo – Guidelines for upgrading Expo SDK versions and fixing dependency issues
- upstash-ratelimit – Add rate limiting to API routes, middleware, and edge functions with @upstash/ratelimit…
- us-watchlist-alerts – Free US stock watchlists, price alerts and daily briefs; no API key, NYSE-holiday aware…
- use-dom – Use Expo DOM components to run web code in a webview on native and as-is on web. Migrate…
- using-git-worktrees – Git worktrees create isolated workspaces sharing the same repository, allowing work on…