Робоча папка .develop

Створює й веде в проєкті папку .develop — глосарій, дослідження, відкриті питання з рішеннями, задачі, готові до Jira, і опис того, як працює система.

Встановити через агента — скажіть йому:

Прочитай https://ufo-tech.space/ai/install.md і встанови скіл develop-folder з каталогу UFO Tech.

Встановлення

Claude Code

У проєкт — .claude/skills/develop-folder

macOS, Linux, WSL, Git Bash

mkdir -p ".claude/skills/develop-folder" ".claude/skills/develop-folder/scripts" ".claude/skills/develop-folder/templates"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -o ".claude/skills/develop-folder/.gitattributes"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/claude/SKILL.md -o ".claude/skills/develop-folder/SKILL.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -o ".claude/skills/develop-folder/scripts/ensure-develop.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -o ".claude/skills/develop-folder/scripts/ensure-develop.sh"
chmod +x ".claude/skills/develop-folder/scripts/ensure-develop.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -o ".claude/skills/develop-folder/scripts/next-number.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -o ".claude/skills/develop-folder/scripts/next-number.sh"
chmod +x ".claude/skills/develop-folder/scripts/next-number.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.ps1 -o ".claude/skills/develop-folder/scripts/session-check.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.sh -o ".claude/skills/develop-folder/scripts/session-check.sh"
chmod +x ".claude/skills/develop-folder/scripts/session-check.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -o ".claude/skills/develop-folder/templates/README.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -o ".claude/skills/develop-folder/templates/bug.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -o ".claude/skills/develop-folder/templates/feature.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -o ".claude/skills/develop-folder/templates/glossary.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -o ".claude/skills/develop-folder/templates/investigation.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -o ".claude/skills/develop-folder/templates/questions.md"

Windows PowerShell

New-Item -ItemType Directory -Force ".claude\skills\develop-folder" | Out-Null
New-Item -ItemType Directory -Force ".claude\skills\develop-folder\scripts" | Out-Null
New-Item -ItemType Directory -Force ".claude\skills\develop-folder\templates" | Out-Null
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -OutFile ".claude\skills\develop-folder\.gitattributes"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/claude/SKILL.md -OutFile ".claude\skills\develop-folder\SKILL.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -OutFile ".claude\skills\develop-folder\scripts\ensure-develop.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -OutFile ".claude\skills\develop-folder\scripts\ensure-develop.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -OutFile ".claude\skills\develop-folder\scripts\next-number.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -OutFile ".claude\skills\develop-folder\scripts\next-number.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.ps1 -OutFile ".claude\skills\develop-folder\scripts\session-check.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.sh -OutFile ".claude\skills\develop-folder\scripts\session-check.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -OutFile ".claude\skills\develop-folder\templates\README.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -OutFile ".claude\skills\develop-folder\templates\bug.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -OutFile ".claude\skills\develop-folder\templates\feature.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -OutFile ".claude\skills\develop-folder\templates\glossary.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -OutFile ".claude\skills\develop-folder\templates\investigation.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -OutFile ".claude\skills\develop-folder\templates\questions.md"
Глобально, для всіх проєктів — ~/.claude/skills/develop-folder

macOS, Linux, WSL, Git Bash

mkdir -p "$HOME/.claude/skills/develop-folder" "$HOME/.claude/skills/develop-folder/scripts" "$HOME/.claude/skills/develop-folder/templates"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -o "$HOME/.claude/skills/develop-folder/.gitattributes"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/claude/SKILL.md -o "$HOME/.claude/skills/develop-folder/SKILL.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -o "$HOME/.claude/skills/develop-folder/scripts/ensure-develop.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -o "$HOME/.claude/skills/develop-folder/scripts/ensure-develop.sh"
chmod +x "$HOME/.claude/skills/develop-folder/scripts/ensure-develop.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -o "$HOME/.claude/skills/develop-folder/scripts/next-number.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -o "$HOME/.claude/skills/develop-folder/scripts/next-number.sh"
chmod +x "$HOME/.claude/skills/develop-folder/scripts/next-number.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.ps1 -o "$HOME/.claude/skills/develop-folder/scripts/session-check.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.sh -o "$HOME/.claude/skills/develop-folder/scripts/session-check.sh"
chmod +x "$HOME/.claude/skills/develop-folder/scripts/session-check.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -o "$HOME/.claude/skills/develop-folder/templates/README.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -o "$HOME/.claude/skills/develop-folder/templates/bug.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -o "$HOME/.claude/skills/develop-folder/templates/feature.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -o "$HOME/.claude/skills/develop-folder/templates/glossary.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -o "$HOME/.claude/skills/develop-folder/templates/investigation.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -o "$HOME/.claude/skills/develop-folder/templates/questions.md"

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude\skills\develop-folder" | Out-Null
New-Item -ItemType Directory -Force "$HOME\.claude\skills\develop-folder\scripts" | Out-Null
New-Item -ItemType Directory -Force "$HOME\.claude\skills\develop-folder\templates" | Out-Null
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -OutFile "$HOME\.claude\skills\develop-folder\.gitattributes"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/claude/SKILL.md -OutFile "$HOME\.claude\skills\develop-folder\SKILL.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -OutFile "$HOME\.claude\skills\develop-folder\scripts\ensure-develop.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -OutFile "$HOME\.claude\skills\develop-folder\scripts\ensure-develop.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -OutFile "$HOME\.claude\skills\develop-folder\scripts\next-number.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -OutFile "$HOME\.claude\skills\develop-folder\scripts\next-number.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.ps1 -OutFile "$HOME\.claude\skills\develop-folder\scripts\session-check.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/claude/scripts/session-check.sh -OutFile "$HOME\.claude\skills\develop-folder\scripts\session-check.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -OutFile "$HOME\.claude\skills\develop-folder\templates\README.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -OutFile "$HOME\.claude\skills\develop-folder\templates\bug.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -OutFile "$HOME\.claude\skills\develop-folder\templates\feature.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -OutFile "$HOME\.claude\skills\develop-folder\templates\glossary.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -OutFile "$HOME\.claude\skills\develop-folder\templates\investigation.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -OutFile "$HOME\.claude\skills\develop-folder\templates\questions.md"

Codex

У проєкт — .agents/skills/develop-folder

macOS, Linux, WSL, Git Bash

mkdir -p ".agents/skills/develop-folder" ".agents/skills/develop-folder/scripts" ".agents/skills/develop-folder/templates"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -o ".agents/skills/develop-folder/.gitattributes"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/codex/SKILL.md -o ".agents/skills/develop-folder/SKILL.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -o ".agents/skills/develop-folder/scripts/ensure-develop.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -o ".agents/skills/develop-folder/scripts/ensure-develop.sh"
chmod +x ".agents/skills/develop-folder/scripts/ensure-develop.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -o ".agents/skills/develop-folder/scripts/next-number.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -o ".agents/skills/develop-folder/scripts/next-number.sh"
chmod +x ".agents/skills/develop-folder/scripts/next-number.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -o ".agents/skills/develop-folder/templates/README.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -o ".agents/skills/develop-folder/templates/bug.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -o ".agents/skills/develop-folder/templates/feature.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -o ".agents/skills/develop-folder/templates/glossary.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -o ".agents/skills/develop-folder/templates/investigation.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -o ".agents/skills/develop-folder/templates/questions.md"

Windows PowerShell

New-Item -ItemType Directory -Force ".agents\skills\develop-folder" | Out-Null
New-Item -ItemType Directory -Force ".agents\skills\develop-folder\scripts" | Out-Null
New-Item -ItemType Directory -Force ".agents\skills\develop-folder\templates" | Out-Null
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -OutFile ".agents\skills\develop-folder\.gitattributes"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/codex/SKILL.md -OutFile ".agents\skills\develop-folder\SKILL.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -OutFile ".agents\skills\develop-folder\scripts\ensure-develop.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -OutFile ".agents\skills\develop-folder\scripts\ensure-develop.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -OutFile ".agents\skills\develop-folder\scripts\next-number.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -OutFile ".agents\skills\develop-folder\scripts\next-number.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -OutFile ".agents\skills\develop-folder\templates\README.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -OutFile ".agents\skills\develop-folder\templates\bug.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -OutFile ".agents\skills\develop-folder\templates\feature.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -OutFile ".agents\skills\develop-folder\templates\glossary.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -OutFile ".agents\skills\develop-folder\templates\investigation.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -OutFile ".agents\skills\develop-folder\templates\questions.md"
Глобально, для всіх проєктів — ~/.agents/skills/develop-folder

macOS, Linux, WSL, Git Bash

mkdir -p "$HOME/.agents/skills/develop-folder" "$HOME/.agents/skills/develop-folder/scripts" "$HOME/.agents/skills/develop-folder/templates"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -o "$HOME/.agents/skills/develop-folder/.gitattributes"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/codex/SKILL.md -o "$HOME/.agents/skills/develop-folder/SKILL.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -o "$HOME/.agents/skills/develop-folder/scripts/ensure-develop.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -o "$HOME/.agents/skills/develop-folder/scripts/ensure-develop.sh"
chmod +x "$HOME/.agents/skills/develop-folder/scripts/ensure-develop.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -o "$HOME/.agents/skills/develop-folder/scripts/next-number.ps1"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -o "$HOME/.agents/skills/develop-folder/scripts/next-number.sh"
chmod +x "$HOME/.agents/skills/develop-folder/scripts/next-number.sh"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -o "$HOME/.agents/skills/develop-folder/templates/README.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -o "$HOME/.agents/skills/develop-folder/templates/bug.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -o "$HOME/.agents/skills/develop-folder/templates/feature.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -o "$HOME/.agents/skills/develop-folder/templates/glossary.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -o "$HOME/.agents/skills/develop-folder/templates/investigation.md"
curl -fsSL https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -o "$HOME/.agents/skills/develop-folder/templates/questions.md"

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.agents\skills\develop-folder" | Out-Null
New-Item -ItemType Directory -Force "$HOME\.agents\skills\develop-folder\scripts" | Out-Null
New-Item -ItemType Directory -Force "$HOME\.agents\skills\develop-folder\templates" | Out-Null
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/.gitattributes -OutFile "$HOME\.agents\skills\develop-folder\.gitattributes"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/codex/SKILL.md -OutFile "$HOME\.agents\skills\develop-folder\SKILL.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.ps1 -OutFile "$HOME\.agents\skills\develop-folder\scripts\ensure-develop.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/ensure-develop.sh -OutFile "$HOME\.agents\skills\develop-folder\scripts\ensure-develop.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.ps1 -OutFile "$HOME\.agents\skills\develop-folder\scripts\next-number.ps1"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/scripts/next-number.sh -OutFile "$HOME\.agents\skills\develop-folder\scripts\next-number.sh"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/README.md -OutFile "$HOME\.agents\skills\develop-folder\templates\README.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/bug.md -OutFile "$HOME\.agents\skills\develop-folder\templates\bug.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/feature.md -OutFile "$HOME\.agents\skills\develop-folder\templates\feature.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/glossary.md -OutFile "$HOME\.agents\skills\develop-folder\templates\glossary.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/investigation.md -OutFile "$HOME\.agents\skills\develop-folder\templates\investigation.md"
Invoke-WebRequest https://ufo-tech.space/ai/files/skill/develop-folder/shared/templates/questions.md -OutFile "$HOME\.agents\skills\develop-folder\templates\questions.md"

Опис

Створює та веде робочу папку .develop/ у корені проєкту:

.develop/
├── README.md                     # коротка шпаргалка з правилами
├── glossary.md                   # терміни й абревіатури, згруповані за темами
├── investigations/<тема>.md      # дослідження, по файлу на тему чи контекст запиту
├── questions/
│   ├── open/<тема>.md            # ⚠️ нові, ⏸️ відкладені
│   ├── accepted/<тема>.md        # ✅ прийняті
│   └── rejected/<тема>.md        # 🛑 відхилені
├── issues/
│   ├── features/<іконка>-NNN-<назва>.md
│   └── bugfix/<іконка>-NNN-<назва>.md
└── docs/                         # як працює функціональність зараз
  • Статуси: ⚠️ нове / чекає рішення · ⏸️ відкладено · ✅ прийнято · 🛑 відхилено · 🏁 реалізовано (тільки задачі). Статус питання змінює лише рішення людини.
  • Питання: нумерація наскрізна для всієї папки questions/. Після рішення питання переїжджає з open/<тема>.md в accepted/<тема>.md чи rejected/<тема>.md разом із датою й формулюванням рішення.
  • Задачі (issues/) з'являються, коли в обговоренні дійшли до запланованої роботи. Шаблони: templates/feature.md і templates/bug.md. Заголовок H1 — це Jira Summary, а все до розділу «Локальні посилання» — Description, яке можна вставити в Jira без правок.
  • docs/ описує поточний стан системи, не плани. Розділи оновлюються, коли задача стає 🏁.
  • Git: папка не потрапляє в git, бо скрипт додає /.develop/ у .git/info/exclude. Це локальний файл, тож спільний ../../../.gitignore не змінюється. CLAUDE.md лишається окремо.

Коли створюється

  • Під час /init: агент підхоплює скіл і запускає ensure-develop одразу після CLAUDE.md (Claude Code) чи AGENTS.md (Codex).

  • Якщо /init був раніше, ніж з'явився скіл:

    • Claude Code — SessionStart hook на старті сесії бачить CLAUDE.md, створює або доповнює .develop/ і повідомляє про це Claude;
    • Codex — hook-а немає: агент сам запускає ensure-develop, коли бачить AGENTS.md без повної .develop/.

    Якщо знайдеться старий формат (.develop/investigate.md, .develop/qa.md, .features/), агент запропонує перенести.

Платформи

Кожен скрипт має дві однакові за поведінкою версії:

Система Версія скриптів Що потрібно
macOS, Linux, WSL .sh bash (підходить і 3.2, як на macOS), git
Windows з Git for Windows (Git Bash) .sh Git for Windows
Windows без Git Bash .ps1 вбудований Windows PowerShell 5.1 або PowerShell 7; git — якщо проєкти в git

Claude Code на Windows без Git for Windows запускає і команди, і hooks через PowerShell. Тому для такої машини потрібні .ps1-версії скриптів і окремий варіант hook.

Встановлення

  1. Встановити скіл глобально — шляхи в SKILL.md (і hook для Claude Code) розраховані саме на це місце: ~/.claude/skills/develop-folder/ для Claude Code, ~/.agents/skills/develop-folder/ для Codex. Найпростіше — попросити агента: «встанови скіл develop-folder з каталогу UFO Tech глобально»; команди для ручного встановлення є вище на цій сторінці.

    Файл .gitattributes у папці скіла тримає .sh-скрипти з LF-закінченнями рядків, якщо скіл зберігається в git. Інакше на Windows із core.autocrlf=true bash на них падає.

  2. Лише для Claude Code: додати hook у ~/.claude/settings.json (на Windows це %USERPROFILE%\.claude\settings.json). Якщо там уже є hooks.SessionStart, допишіть елемент у наявний масив, а не замінюйте його.

    macOS, Linux, WSL, Windows з Git Bash:

    {
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$HOME/.claude/skills/develop-folder/scripts/session-check.sh\"",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

    Windows без Git Bash:

    {
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "shell": "powershell",
            "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"$HOME\\.claude\\skills\\develop-folder\\scripts\\session-check.ps1\"",
            "timeout": 15
          }
        ]
      }
    ]
  }
}

    -ExecutionPolicy Bypass діє лише на цей запуск, системну політику він не змінює.

Codex цей крок не потрібен. Без кроку 2 скіл теж працює, але папку буде створено лише під час /init або коли Claude сам помітить CLAUDE.md без .develop/.

Склад

Встановлений скіл:

develop-folder/
├── SKILL.md                        # правила для агента (свої для Claude Code і для Codex)
├── .gitattributes                  # LF для .sh, щоб bash не падав на Windows
├── scripts/ensure-develop.sh|.ps1  # створює або доповнює .develop; наявні файли не перезаписує
├── scripts/next-number.sh|.ps1     # наступний вільний номер: questions | features | bugfix
├── scripts/session-check.sh|.ps1   # SessionStart hook (лише Claude Code)
└── templates/                      # README, glossary, investigation, questions, feature, bug

У каталозі скрипти й шаблони лежать один раз у shared/, а в claude/ і codex/ — лише те, що відрізняється.

<div class="docs-page-votes" data-page-votes hidden data-endpoint="/votes" role="group" aria-label="Оцінка сторінки"> <button class="docs-page-votes__button" type="button" data-vote="1" aria-pressed="false" title="Корисно"> <span aria-hidden="true">👍</span> <span class="visually-hidden">Корисно</span> <span data-vote-count>0</span> </button> <button class="docs-page-votes__button" type="button" data-vote="-1" aria-pressed="false" title="Не корисно"> <span aria-hidden="true">👎</span> <span class="visually-hidden">Не корисно</span> <span data-vote-count>0</span> </button> </div> <p class="docs-page-counters" data-page-counters hidden data-endpoint="/_e/page" data-label-total="Переглянуто: {count} {times}" data-label-now="Зараз переглядають: {count}" data-times="{&quot;one&quot;:&quot;\u0440\u0430\u0437&quot;,&quot;few&quot;:&quot;\u0440\u0430\u0437\u0438&quot;,&quot;many&quot;:&quot;\u0440\u0430\u0437\u0456\u0432&quot;,&quot;other&quot;:&quot;\u0440\u0430\u0437\u0443&quot;}"> <span data-page-counters-total></span> <span aria-hidden="true">·</span> <span data-page-counters-now></span> </p>