К основному содержанию
скилл CX Codex

tlc-plan — скилл для Claude Code: что делает и как установить

Скилл tlc-plan превращает PRD, тикеты и обсуждения в строгий план разработки. Уточняет серые зоны до написания кода и фиксирует критерии приёмки.

CC-BY-4.0 ★ 7 191 обновлён 2026-11-02

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tech-leads-club/agent-skills --skill tlc-plan -a claude-code
Открыть на GitHub

Что делает tlc-plan

Скилл берёт задачу, тикет или дизайн и формирует спецификацию в .specs/features/<feature>/plan.md. Перед составлением плана агент задаёт прямые вопросы по всем спорным местам интерфейса и логики. Пока серые зоны не закрыты, агент не переходит к оформлению финального документа.

В итоговый файл попадают измеримые критерии EARS с конкретными значениями, схема движения данных в Mermaid и только трудноотменимые архитектурные решения. Связанные решения логируются в .specs/STATE.md. Для запуска встроенных проверок и поиска прошлых ошибок через scripts/lessons.py потребуется Python 3.8 или новее.

Без успешного прогона валидатора validate_plan.py и точной цитаты подтверждения от человека план не считается готовым к передаче в разработку.

Какие задачи решает

  • составить спецификацию функции по тикету или PRD
  • выявить скрытые развилки в логике до начала кодинга
  • зафиксировать проверяемые критерии приёмки в формате EARS
  • вести историю архитектурных решений в проекте

Примеры запросов агенту

  • Спланируй задачу по тикету #42 через tlc-plan
  • Распиши план фичи авторизации по этому PRD
  • Выдели задачи и подготовь plan.md для нового эндпоинта

Как установить tlc-plan

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill tlc-plan -a claude-code

2Вручную: положить файлы

~/.claude/skills/tlc-plan/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tlc-plan/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tlc-plan

Как установить tlc-plan в Claude Code?

Выполните команду npx skills add tech-leads-club/agent-skills --skill tlc-plan -a claude-code. Также можно вручную поместить файл по пути ~/.claude/skills/tlc-plan/SKILL.md.

Что делает скилл tlc-plan?

Он опрашивает пользователя о неясных требованиях и создаёт структурированный plan.md с критериями EARS и диаграммами Mermaid. Полученный документ служит однозначным заданием для этапа реализации.

Что нужно для работы вспомогательных скриптов скилла?

Понадобится Python 3.8+ со стандартной библиотекой. Он запускает проверку структуры через scripts/validate_plan.py и чтение уроков из scripts/lessons.py.

Исходный текст

SKILL.md · CC-BY-4.0
---
name: tlc-plan
description: 'Turns a request, ticket, PRD, design or thread into one plan a human approves and a builder can act on without the conversation: asks every gray area until no product decision is left to the builder, then writes the problem, EARS criteria with concrete values, the path and the data it touches (drawn in mermaid), the interface, and only the decisions that are hard to reverse. Captures that come with the request bind. Use when the user says "plan this", "plan feature", "specify feature", "write the plan", "cut this PRD into tasks", or "tlc-plan". Do NOT use to implement (that is tlc-implement), for a standalone design document, or when nobody has decided what to build.'
license: CC-BY-4.0
metadata:
  author: Tech Leads Club - github.com/tech-leads-club
  version: 1.1.1
---

# TLC Plan

Ask until nothing is the builder's to decide. Write it down so a stranger can build it.

```
┌─────┐   ┌───────┐   ┌──────┐   ┌─────────┐
│ ASK │ → │ SHAPE │ → │ CHECK│ → │ APPROVE │ → tlc-implement
└─────┘   └───────┘   └──────┘   └─────────┘
```

The common failure of a coding agent is a requirement that never became an obligation, followed by
a completion claim. It starts here: a gray area the plan settled by guessing, a capture treated as
a suggestion, a sentence of the request that landed nowhere. This skill produces the one document a
human reads and objects to before any code exists, and it is the whole brief for whoever builds,
often a different agent with none of this conversation.

## Rules

1. Every criterion is one observable outcome with a concrete value - a status code, a field, a
   bound, a label - that one run settles. "Gracefully", a percentile or "the columns exist" is not
   a criterion.
2. Ask every gray area before presenting the plan: a decision that is the user's, has more than one
   defensible answer, and is not settled by the code. An assumption never stands in for a question
   to save one. Asking clarifies how, never whether to add a capability.
3. A capture, frame or live site that comes with the request binds unless the user called it
   inspiration. Only the user changes a binding source: a departure from it is asked, recorded as
   an `AD-NNN` in `.specs/STATE.md`, and listed in `## Differences from the source`.
4. The rules that change what a user sees run in a layer the repo's tests reach. Filtering,
   searching, sorting and counting are rules.
5. Only what is hard to reverse is decided here, with its literal shape. Placement, names and
   types inside the conventions are the builder's and are settled in the diff.
6. `validate_plan.py` exits 0 before the plan is presented, and approval is the one stop for a
   human. The approval is written under the plan's title as
   `**Approved**: <date> - user: "<their words>"` - never one the user did not give - and each
   answer goes into the plan in the turn it arrives: a compaction keeps the file, not the chat.
   After one, or in a new session, re-read this file and the plan reference, then continue from
   `plan.md`. The plan stays true through the build: `Landing`, `Surface` and the data are additive;
   the path and `Changes underneath` change in the commit that changes them.

## Cut: how many plans

Read every source completely, then decide how many plans it becomes. Default to one. Every one-way
door in the source is then reviewed together, where the interactions between them are visible;
split six ways, the same doors arrive in six batches and nobody sees the whole.

Split only for a reason you can defend from evidence: a piece cannot land before another without
breaking production, a piece waits on an answer only someone else can give, or a piece belongs to
another team. Each piece is then its own feature folder with its own plan.

Say when it is big, and what makes it big: one-way doors first, a migration among them, then the
number of slices. Show the seams that exist - order constraints first, marked as the kind that
cannot be collapsed - and let the user pick where to cut.

A slice inside a plan is one outcome someone can watch, never a layer. Preparation that proves
nothing on its own - a nullable column, a client with no caller - is a commit, not a slice.

## Artifacts

```
.specs/
├── STATE.md                    # decisions log (AD-NNN)
├── LESSONS.md                  # rendered by scripts/lessons.py - read it
└── features/<feature>/
    ├── plan.md                 # problem, shape, surface, doors, criteria
    └── captures/               # the binding source files
```

The plan format, how to ask, the surface walk and EARS: [references/plan.md](references/plan.md).
Its section headings are a schema **tlc-implement** and the validator read; prose follows the
project's language, and identifiers are never translated.

## Decisions and lessons

`.specs/STATE.md` holds the decisions a future feature has to conform to:

```markdown
# Project state

## Decisions

| ID | Decision | Rationale | Status | Date |
| --- | --- | --- | --- | --- |
| AD-001 | Webhook ingest is idempotent on provider delivery id | replays are routine and cheap to dedup at the edge | active | 2026-02-14 |
```

Edit only the body of `## Decisions`. Where the repo already keeps ADRs or a decision log, append
there instead. Every `active` entry constrains the plan: conform, or append one that supersedes it
(the old row's status becomes `superseded by AD-NNN`) and say why. An answer that departs from a
binding source is a decision: it says what the product shows instead, and its rationale quotes the
question and the option chosen.

Lessons are written by **tlc-implement** from real verification findings. Read the confirmed ones
for the area before asking anything:

```bash
python3 <skill-dir>/scripts/lessons.py --root <project> list --status confirmed [--scope <area>]
```

## Scripts

Resolve `<skill-dir>` as the directory containing this `SKILL.md`. Pass `--root` when cwd is not
the project root. Run a script rather than read it: its messages say what to change. On Windows,
where `python3` may be the Microsoft Store alias, run `python` or `py -3`.

| When | Command |
| --- | --- |
| Before presenting the plan, and after each change to it | `python3 <skill-dir>/scripts/validate_plan.py <feature>` |
| Before asking anything | `python3 <skill-dir>/scripts/lessons.py --root <project> list --status confirmed` |
| After editing the validator or the template | `python3 <skill-dir>/scripts/selftest.py` |

## Requires

| Needs | For | Without it |
| --- | --- | --- |
| Python 3.8+ (standard library only) | the scripts | the plan still applies; say the validator did not run |
| a model that reads images | binding captures | ask the user to describe each state, and say so in `Sources` |
| access to the design source (file, MCP, URL) | exporting each state to `captures/` | ask for the files as a `blocks` question |

## Output

Produce the artifact; do not narrate the phase. When you stop, lead with the verdict: the plan, the
questions that block first with your recommendation, then the defaults you picked for the user to
correct. Section headings stay in English.

© Tech Leads Club - github.com/tech-leads-club · CC-BY-4.0 · tech-leads-club/agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
prd snarktank Скилл опрашивает разработчика и формирует структурированный PRD для новой фичи в файле tasks/prd-[feature-name].md. Помогает зафиксировать требования до написания кода. CX Codex +1 1 500установок requirement-convergence shinpr Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо feature-spec pproenca Скилл feature-spec для Claude Code задаёт 42 правила для PRD, фиксации скоупа и приоритизации задач. Помогает спланировать функционал до написания кода. CX Codex +1 438установок PRD Builder microsoft PRD Builder — субагент для Claude Code, который пошагово составляет продуктовые требования через опросник, связывает метрики со словарём телеметрии и готовит спецификацию к планированию задач. CX Codex +1 ★ 1 627звёзд репо 10x-plan przeprogramowani Команда 10x-plan для Claude Code исследует кодовую базу и составляет детальный план реализации фичи до написания кода. CX Codex +1 ★ 267звёзд репо prd-development deanpeters Скилл prd-development помогает составить структурированный PRD из заметок дискавери, связав проблему, метрики и пользовательские истории. Пригодится перед запуском крупной фичи в разработку. CX Codex +1 4 900установок

Из того же набора130

Весь набор →
learning-opportunities Скилл learning-opportunities предлагает короткие учебные упражнения после архитектурной работы в Claude, чтобы код, который написал агент, не остался для вас чёрным ящиком. CX Codex +1 ★ 7 191звёзд репо confluence-assistant Скилл confluence-assistant учит агента работать с Confluence через Atlassian MCP. Помогает искать страницы поиском Rovo, создавать новые записи в разметке Markdown и обновлять документацию прямо из чата. CX Codex +1 ★ 7 191звёзд репо security-threat-model Скилл security-threat-model строит модель угроз по коду репозитория: находит границы доверия, активы и реалистичные пути атаки, а результат сохраняет в Markdown-файл. CX Codex +1 ★ 7 191звёзд репо modular-decomposition Скилл modular-decomposition проводит монолит через пять шагов анализа перед разбивкой на модули: размер и инвентаризация компонентов, дублирование логики, иерархия, связность, группировка по доменам. CX Codex +1 ★ 7 191звёзд репо legacy-migration-planner Скилл legacy-migration-planner планирует миграцию легаси-систем, модернизацию кодовой базы и разбиение монолита. Он пригодится до начала работ, когда нужен план перехода. CX Codex +1 ★ 7 191звёзд репо shopify-developer Скилл shopify-developer для Claude Code даёт агенту справочник по Liquid, темам OS 2.0, GraphQL API, Functions и Hydrogen для разработки под Shopify. CX Codex +1 ★ 7 191звёзд репо aws-advisor Скилл aws-advisor консультирует по архитектуре AWS, проверяет безопасность и сверяет параметры сервисов с документацией через MCP-инструменты. CX Codex +1 ★ 7 191звёзд репо rails-dev Скилл rails-dev для Claude Code задаёт конвенции Ruby on Rails: богатые модели, состояния-записи, Minitest с фикстурами и минимум внешних гемов. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой