メニュー
Which document to update for a given behaviour change in this repo. Use at the end of any change that alters endpoints, domain rules, schema, packages, wiring, or features — docs/ is a first-class deliverable and must ship in the same PR.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/fjaeckel/ninerlog-api --skill docs-syncコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
The OpenAPI-first workflow for this repo. Use whenever adding, removing, or changing an HTTP endpoint, request/response field, status code, query parameter, or auth requirement — and before touching anything under internal/api/generated/ or api-spec/openapi.yaml.
Database schema changes in this repo — creating golang-migrate migration pairs, naming and numbering rules, the reversible-down requirement, the test-DB init script, and repository/model follow-up. Use whenever adding a table, column, index, or constraint.
How to write and run tests in this repo — unit vs integration vs e2e, the build tags and env vars each tier needs, running a single test, and the pre-commit gate. Use before writing a test, running the suite, or claiming work is done.
| name | docs-sync |
| description | Which document to update for a given behaviour change in this repo. Use at the end of any change that alters endpoints, domain rules, schema, packages, wiring, or features — docs/ is a first-class deliverable and must ship in the same PR. |
Documentation in docs/ is part of the codebase. A change is not complete until its
documentation matches reality. Update in the same PR:
| Changed | Update |
|---|---|
| HTTP contract / endpoints | api-spec/openapi.yaml, docs/API.md, docs/FEATURES.md |
| Domain rules (flights, currency, validation, time handling) | docs/DOMAIN.md |
| Entities, schema, migrations | docs/DATA_MODEL.md |
| Packages, responsibilities, startup wiring | docs/PACKAGES.md, docs/ARCHITECTURE.md |
| A product feature added/removed/changed | docs/FEATURES.md |
| Auth, metrics, performance, test tooling | docs/AUTHENTICATION.md, docs/METRICS.md, docs/PERFORMANCE.md, docs/RUNNING_TESTS.md |
| Developer workflow / commands | docs/DEVELOPMENT.md, CONTRIBUTING.md, README.md |
Guidelines:
internal/api/generated/) —
regenerate them.docs/DEVELOPER_GUIDE.md is the entry point and documentation map; keep its links valid..github/copilot-instructions.md is stale and contradicts the codebase in places
(TypeScript/Prisma/sqlc examples). Do not treat it as a source of truth; if you touch it,
correct it toward docs/.