Codex TZ Skill Pack for CollabSphere

Пакет переводит workflow в markdown-first и preanalysis-first режим.

Что внутри

• agents.md — человекочитаемый entrypoint для правил репозитория
• AGENTS.md — compatibility filename для agent tooling
• .agents/skills/tz-writer/ — reusable skill
• docs/business-request/_template.md — шаблон входящего запроса
• docs/preanalysis/_template.md — шаблон преданализа
• .markdownlint.json / .markdownlintignore — базовые правила markdownlint
• .codex/config.toml — опциональная project-level конфигурация

Новый workflow

Локальное эволюционное изменение

1. business-request
2. preanalysis
3. решение proceed-local
4. technical-spec
5. при необходимости .docx / .pdf

Крупное или рискованное изменение

1. business-request
2. preanalysis
3. решение proceed-staged / require-approval / require-architecture-review
4. docs/initiatives/<initiative-slug>/...
5. phase plan и отдельные stage specs
6. только потом детальные ТЗ по этапам

Команды

Создать только business-request

python .agents/skills/tz-writer/scripts/render_business_request.py   --title "Redis filters for catalog API"   --output docs/business-request/2026-03-21_redis-filters-for-catalog-api.md   --owner "nikolay"

Создать preanalysis

python .agents/skills/tz-writer/scripts/render_preanalysis.py   --title "Redis filters for catalog API"   --output docs/preanalysis/2026-03-21_redis-filters-for-catalog-api.md   --owner "platform"   --source-request docs/business-request/2026-03-21_redis-filters-for-catalog-api.md   --decision proceed-local

Создать technical spec

python .agents/skills/tz-writer/scripts/render_md.py   --title "Redis filters for catalog API"   --output docs/technical-specs/backend/catalog-redis-filters.md   --owner "platform"   --status draft   --source-request docs/business-request/2026-03-21_redis-filters-for-catalog-api.md   --source-preanalysis docs/preanalysis/2026-03-21_redis-filters-for-catalog-api.md   --bounded-context catalog   --capability redis-filters

Полный local workflow

python .agents/skills/tz-writer/scripts/render_full.py   --title "Redis filters for catalog API"   --bounded-context catalog   --capability redis-filters   --owner "platform"   --request-owner "nikolay"   --decision proceed-local   --docx   --pdf

Полный gated workflow

python .agents/skills/tz-writer/scripts/render_full.py   --title "Provider platform for EDO + KYC"   --bounded-context integration   --capability provider-platform   --owner "platform"   --request-owner "nikolay"   --decision require-approval   --mode gated

PlantUML docs pipeline

python scripts/generate_diagrams.py docs
python scripts/generate_diagrams.py docs --check
make docs-diagrams-generate
make docs-diagrams-check
make docs-site-check
make check-docs

Что создаёт render_full.py

Local mode / proceed-local

• canonical markdown:
  • docs/business-request/YYYY-MM-DD_<slug>.md
  • docs/preanalysis/YYYY-MM-DD_<slug>.md
  • docs/technical-specs/<bounded-context>-<capability>.md
• snapshots в artifacts/<bundle-id>/
• опционально .docx и .pdf
• manifest.json

Gated mode / staged decisions

• canonical markdown:
  • docs/business-request/YYYY-MM-DD_<slug>.md
  • docs/preanalysis/YYYY-MM-DD_<slug>.md
  • docs/initiatives/<initiative-slug>/00-business-request.md
  • docs/initiatives/<initiative-slug>/01-preanalysis.md
  • docs/initiatives/<initiative-slug>/02-decision.md
  • docs/initiatives/<initiative-slug>/03-phase-plan.md
• snapshots в artifacts/<bundle-id>/
• manifest.json

Замечания

• Markdown — canonical source. Не редактируйте DOCX / PDF руками.
• render_full.py не подменяет инженерное мышление: decision model нужно заполнять осмысленно.
• Для будущего импорта в Git / Atlassian / внутренние системы сохраняйте стабильный front matter и простую markdown-структуру.
• PlantUML в markdown допускается как optional enhancement. Источником истины остаётся markdown-документ, а .puml / .svg считаются производными артефактами.