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

software-lifecycle — скилл для Claude Code: цикл документов проекта

Скилл software-lifecycle держит порядок в документах проекта: предложения, решения, спеки, постмортемы и гайды. Скилл знает статусы и правила для каждой папки.

MIT 245 установок ★ 17 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add inkeep/open-knowledge-skills --skill software-lifecycle -a claude-code
Открыть на GitHub

Что делает software-lifecycle

Скилл задаёт порядок в проекте, где документация идёт по цепочке proposals/ → decisions/ → specs/ → postmortems/, а guides/ служит справочником. Он держит статусы и правила для каждой папки, чтобы агенту не приходилось угадывать по названиям файлов. Шаблоны при этом несут только структуру: заголовки и фронтматтер.

Часть работы скилл берёт на себя. Черновик предложения, который висит в status: draft дольше 14 дней, он поднимает наверх: двигать, парковать или закрывать. Перед коммитом нового решения сканирует соседние записи и показывает кандидатов на Supersedes:. После публикации постмортема собирает блок Related: со старыми разборами по тем же подсистемам. У гайдов есть last_verified, поэтому просроченные видно на периодическом ревью.

Пять рабочих сценариев живут отдельными скиллами: фрейм предложения, спека, запись решения, постмортем и ревью дизайна — /frame-a-proposal, /write-a-spec, /record-a-decision, /write-a-postmortem, /review-a-design. Сам software-lifecycle ставится в проект через ok seed --pack software-lifecycle (для Beta есть ok-beta), и нужен настроенный MCP-сервер OpenKnowledge. Без него скилл не запустится. Платформенный скилл /open-knowledge он дополняет, а не заменяет.

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

  • разложить предложения, решения и спеки по папкам проекта
  • провести черновик предложения по статусам до accepted
  • найти старое решение, которое новое должно перекрыть
  • собрать постмортем по инциденту без поиска виноватых
  • завести гайд из пунктов постмортема

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

  • Покажи, как в этом проекте идут документы от предложения до постмортема.
  • У меня черновик в proposals/ висит давно — что дальше по статусам?
  • Проверь, не надо ли новому решению сослаться на старое через Supersedes:.

Как установить software-lifecycle

1Через Skills CLI (Vercel)

npx skills add inkeep/open-knowledge-skills --skill software-lifecycle -a claude-code

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

~/.claude/skills/software-lifecycle/SKILL.md

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

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

Вопросы о software-lifecycle

Как установить software-lifecycle в Claude Code?

Выполните npx skills add inkeep/open-knowledge-skills --skill software-lifecycle -a claude-code. Файл скилла окажется в ~/.claude/skills/software-lifecycle/SKILL.md.

Что делает software-lifecycle?

Описывает жизненный цикл документов в проекте: статусы для proposals/, decisions/, specs/ и postmortems/, поведение агента в каждой папке и правила работы с шаблонами.

Что нужно, чтобы скилл заработал?

Настроенный MCP-сервер OpenKnowledge в агенте и установка в проект через ok seed --pack software-lifecycle. Платформенный скилл /open-knowledge он дополняет, но не заменяет.

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

SKILL.md · MIT
---
name: software-lifecycle
description: "How to work in a Software Lifecycle project (the `software-lifecycle` starter pack): proposals → decisions → specs → postmortems, plus guides. Read when the project has these folders, or when asked how this project is organized. Carries the doc lifecycle, status flows, and per-folder agent behaviors so that guidance does not live inside template bodies or folder descriptions. The five workflows — frame a proposal, write a spec, record a decision, write a postmortem, review a design — each ship as their own sibling skill in this pack. Complements the platform `open-knowledge` skill; does not replace it."
compatibility: "Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack software-lifecycle` (`ok-beta` for Beta)."
metadata:
  pack: "software-lifecycle"
  author: "Inkeep"
  repository: "https://github.com/inkeep/open-knowledge-skills"
---
# Software Lifecycle pack — how to work here

This project holds the doc lifecycle for an engineering team or OSS project. The flow is **proposals → decisions → specs → postmortems**, with **guides** as the how-to bucket. This skill holds the workflow so templates and folder descriptions stay clean.

> This skill is pack guidance. The platform `/open-knowledge` skill (read/write/preview/linking/grounding rules) still governs every markdown operation — this layers the lifecycle conventions on top.

## The flow

```
proposals/    in-flight RFC-shape design proposals
   ↓ accepted
decisions/    frozen ADRs (the record of what was decided)
   ↓ derived
specs/        implementation specs for accepted proposals
   ↓ when things break
postmortems/  blameless incident write-ups
guides/       how-to / onboarding / runbooks (referenced throughout)
```

## Per-folder rules + agent behaviors

**`proposals/`** — One file per proposal (`0001-feature-name.md`). Status flows `draft → fcp → accepted/rejected`. An accepted proposal graduates to a record in `decisions/`. Shape: Motivation / Design / Drawbacks / Alternatives / Unresolved questions. *Agent: when a proposal sits at `status: draft` more than 14 days, surface it for the author to advance, park, or close.*

**`decisions/`** — Architecture Decision Records (MADR / Nygard shape). Frozen once accepted. One file per decision (`NNNN-title.md`); status `proposed/accepted/deprecated/superseded`. A new decision that supersedes an older one links back via `Supersedes:`. *Agent: on a new decision, scan existing records touching the same subsystem and surface `Supersedes:` candidates before commit.*

**`specs/`** — Implementation specs derived from accepted proposals. Prefer the `github/spec-kit` shape: one folder per spec (`specs/NNN-name/`) with `spec.md` + `plan.md` + `tasks.md` (the pack ships all three templates). References the parent proposal. *Agent: when a spec moves to `status: shipped`, suggest a postmortem template if the owner reports an incident in the spec's subsystem.*

**`postmortems/`** — Blameless incident write-ups, one file per incident (`YYYY-MM-DD-name.md`): Summary / Timeline / Root cause / What went well / Action items (Google SRE shape). *Agent: surface a `Related:` block linking prior postmortems that share subsystems.*

**`guides/`** — How-to guides, onboarding docs, and service-bound runbooks (Diátaxis how-to). Ships `guide`, `onboarding-guide`, and `runbook` templates. Carries `last_verified` so stale guides surface in periodic reviews. *Agent: when a postmortem is published, scan its action items for guide-shaped follow-ups and stub a guide pre-filled with the symptom and timeline excerpt.*

## The five workflows

Authoring in this project is procedural, not conventional. Each workflow ships as its own skill so it loads only when the work calls for it — reach for the one that matches the task rather than writing into a folder from scratch.

| Workflow | Sibling skill | When |
| --- | --- | --- |
| Frame a proposal | `/frame-a-proposal` | A change needs designing and arguing before anyone builds it. |
| Write a spec | `/write-a-spec` | An accepted proposal needs scoping into an implementable spec. |
| Record a decision | `/record-a-decision` | A decision was actually made and needs its context and consequences preserved. |
| Write a postmortem | `/write-a-postmortem` | An incident happened and the team needs a blameless write-up. |
| Review a design | `/review-a-design` | An existing proposal, spec, or decision needs pressure-testing for soundness. |

## Templates

Create docs with `write({ document: { path, template: "<name>" } })`. Templates carry only structure (headings + frontmatter scaffold); what each section is for is described above, not repeated in the document body.

© Inkeep · MIT · inkeep/open-knowledge-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
software-engineer siviter-xyz Скилл software-engineer задаёт агенту правила стиля кода, документации и рабочего процесса: без лишних комментариев, без самовольных git-коммитов, с вопросами при неясностях. CX Codex +1 637установок recording-decisions riekelt Скилл recording-decisions записывает принятые решения в формате ADR или короткой записи журнала, пока они не остались только в чате. CX Codex +1 26 500установок cursor-spec-interviewer stark-ai-de Скилл cursor-spec-interviewer для Claude Code, Codex, Cursor и других агентных платформ превращает размытый запрос в согласованную спецификацию реализации с критериями приёмки. CX Codex +1 2 700установок decision-records skymavis Скилл decision-records ведёт реестр решений в стиле ADR: черновики, принятые записи, архивирование и замена. Плюс сам генерирует INDEX.md и перекрёстные ссылки. CX Codex +1 8 600установок decision-doc-sync purrfold Скилл decision-doc-sync для Claude Code и других агентов: синхронизирует README, DESIGN, AGENTS и ADR с кодом после архитектурных и UX-изменений. Удерживает документацию от расхождения с кодом. CX Codex +1 5 700установок writing-adrs pandoscope Скилл writing-adrs для Claude Code задаёт формат, нумерацию и критерии Architecture Decision Record. Записывает решения по архитектуре, когда они трудны на откат, удивляют без контекста и выбраны из вариантов. CX Codex +1 1 700установок

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

Весь набор →
review-a-design Скилл review-a-design проверяет архитектурные предложения, спецификации и ADR на логическую состоятельность. Выявляет слабые места в аргументах и не переписывает текст за автора. CX Codex +1 252установок record-a-decision Скилл record-a-decision для Claude Code оформляет принятое архитектурное решение в ADR с контекстом, вариантами и последствиями. Ведёт последовательный журнал решений. CX Codex +1 252установок frame-a-proposal Скилл frame-a-proposal превращает задачу на дизайн в обозримое RFC: сначала фиксирует проблему и получателя, затем ведёт к вариантам, минусам и открытым вопросам. CX Codex +1 248установок write-a-spec Скилл write-a-spec превращает принятое предложение в спецификацию реализации с картой текущей системы, журналом решений, вопросами, миграцией и тестами. CX Codex +1 247установок write-a-postmortem Скилл write-a-postmortem помогает разобрать сбой и составить отчёт по стандартам Google SRE в папке postmortems/. Он исключает обвинения людей и опирается на факты. CX Codex +1 243установок note-taking Скилл note-taking организует ведение заметок в папке notes/ и ежедневный журнал в daily/. Помогает фиксировать мысли и связывать страницы перекрёстными ссылками. CX Codex +1 179установок personal-crm Скилл personal-crm для Claude Code превращает заметки о людях, компаниях и встречах в связанное Markdown-хранилище. Ведёт личную CRM через ИИ-агента. CX Codex +1 126установок writing-workflow Скилл writing-workflow для Claude Code и Codex организует подготовку статей и заметок в три шага: идеи, черновики и публикации. Включается при записи идеи, редактировании текста или выпуске материала. CX Codex +1 102установок

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

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