Summary: Documents stating our position on what we will and will not do: developer environment goals, security stance, human/AI responsibilities. Each document states our position on a topic; specifications implement the stance. 概要: 我々が何をし、何をしないかの立場を述べる文書:開発環境のゴール、セキュリティの姿勢、人と AI の責任。各文書はトピックに関する私たちの立場を述べ、仕様がその立場を実装します。
- Version / 版: 0.2 — 2026-11-06. Learned: a glossary term is only explained for the reader when its note and REF-01 link sit at the first prose use, counting lower-case and plural forms, so first-use notes with links were added in both halves (SPEC-06 §3). / 用語注と REF-01 へのリンクは、小文字や複数形も含めた本文の初出に置かなければ読者に届かないと分かったため、英和両方の初出にリンク付きの用語注を補った(SPEC-06 §3)。
- Version / 版: 0.1 — 2026-11-05. Learned: writing the stance down first showed that "public documentation, private code" is not a detail but the rule every other document depends on. / 立場を先に書いてみると、「文書は公開、コードは非公開」が細部ではなく他の全文書の前提だと分かった。
- Normative for: POL-01 Position and future policy documents.
- Related: ../README.md · ../spec/ · decisions/ · reference/REF-01_Glossary.md
A policy is the position we take. This folder contains:
| File | Purpose |
|---|---|
| POL-01_Developer_Environment_2027_Position.md | Our stance on why and how we build the developer environment 2027. |
Future policies may include:
| Topic | Description |
|---|---|
| POL-02 | Folder and file naming rules |
| POL-03 | Pull request rules |
| POL-04 | Release process |
| POL-05 | Human/AI responsibilities |
flowchart TD
P[Policy: position on a topic] --> S[Spec: rules to implement]
P --> A[Decision record: why we chose this]
S --> C[Code: implement the rule]
A --> C
- Name the file
POL-NN_<Title>.md(two-digit number). - Follow SPEC-06 documentation conventions.
- Link to other documents that depend on this policy.
- The owner approves; AID (the role that writes code and documents to the specification; see REF-01) writes the implementation spec.
「方針」は私たちの立場を書いたものです。このフォルダには次が含まれます:
| ファイル | 目的 |
|---|---|
| POL-01_Developer_Environment_2027_Position.md | 開発環境 2027 版を、なぜ・どのように作るかの立場。 |
今後の方針として以下が考えられます:
| トピック | 説明 |
|---|---|
| POL-02 | フォルダとファイル命名規則 |
| POL-03 | プルリクエスト規則 |
| POL-04 | リリースプロセス |
| POL-05 | 人と AI の責任 |
flowchart TD
P[方針:トピックに関する立場] --> S[仕様:実装するルール]
P --> A[決定の記録:なぜこの道を選んだか]
S --> C[コード:ルールを実装]
A --> C
- ファイル名を
POL-NN_<題>.md(2 桁の番号)にする。 - SPEC-06 文書規約に従う。
- この方針に依存する他の文書へリンクする。
- 所有者が承認;AID(AI開発担当者。仕様どおりにコードと文書を書く役割。REF-01)が実装仕様を書く。
| Term | English note | 日本語注 |
|---|---|---|
| Policy | A statement of our position on what we will and will not do. | 我々が何をし、何をしないかの立場。 |
| Spec | A rule book that implementers must follow. | 実装する人が守るルールブック。 |
| Decision record (ADR) | A note explaining why we chose one way and not another. | なぜその道を選び、ほかを選ばなかったかのメモ。 |
| Implementation | Writing code that follows the spec. | 仕様に従ってコードを書くこと。 |
| Owner | The human who approves policies. | 方針を承認する人。 |