SDD 기반 DevLog AI 역할·모델 라우팅을 구성한다

.agents/rules/general.md

@@ -21,6 +21,7 @@
 ## Documentation placement
 
 - Keep AI workflow and rule documents under `.agents/`.
+- Keep approved workflow Specs under `.agents/specs/`.
 - Keep `docs/` for README images and draw.io sources.
 - Do not add AI workflow documents under `docs/`.
 

.agents/rules/project-workflows.md

@@ -21,6 +21,12 @@ This reference holds DevLog-specific working rules that should live with the pro
 - CI is build validation, not a full test run, unless the workflow changes.
 - Avoid unrelated generated project and `Package.resolved` churn. Generated Xcode workspace/project files should not be tracked unless the project explicitly changes that policy.
 
+## SDD execution authority
+
+- An approved Spec records behavioral constraints, acceptance criteria, and prohibited actions.
+- A `Task Packet` records role assignment and current-turn execution authority separately from the Spec.
+- Record app or Simulator execution, external writes, CI or PR actions, and verification commands separately in both artifacts. Do not infer authorization from a Spec or a `Task Packet` field that does not grant it.
+
 ## Xcode project file work
 
 - Inspect Swift imports and Tuist target dependencies together.

.agents/specs/README.md

@@ -0,0 +1,56 @@
+# DevLog Spec Format
+
+`Designer Result`를 사용자가 승인한 뒤, Planner가 비단순 설계 또는 구현 작업마다 이 디렉터리에 Spec을 작성한다. Spec 이름은 `<issue-number>-<short-topic>.md` 형식을 사용한다.
+
+## Responsibility
+
+- `Design Brief`는 Planner가 요청, 현재 상태, 범위, 제외 범위, 알려진 제약을 Designer에게 전달하는 입력이다.
+- `Designer Result`는 Designer가 제약, 대안, 변경 경계, 수용 기준, 검증, 최소 커밋 단위를 분석한 승인 대기 결과다.
+- Spec은 사용자가 승인한 `Designer Result`를 영속화한 구현·검토·검증의 공통 기준이다.
+- `Task Packet`은 승인된 Spec 경로와 수용 기준을 참조하고, 현재 작업의 역할 배정과 실행 권한을 전달한다.
+
+## Required format
+
+```md
+# <Spec title>
+
+- Source:
+- Approved Designer Result:
+- User approval:
+
+## Constraints
+
+-
+
+## Alternatives and decision
+
+-
+
+## Changed boundaries
+
+-
+
+## Acceptance criteria
+
+- [ ]
+
+## Verification
+
+- Command:
+- Evidence:
+
+## Minimum commit units
+
+1.
+
+## Execution constraints
+
+- app or Simulator execution:
+- External writes:
+- CI or PR actions:
+```
+
+## Change control
+
+- 구현 중 요구 사항 또는 범위가 바뀌면 Spec을 수정하고 사용자 재승인을 받은 뒤에만 `Task Packet`과 구현을 갱신한다.
+- Spec은 동작과 수용 기준, 금지된 실행을 기록한다. `Task Packet`은 역할별 현재 작업 권한과 실제 검증 명령을 별도로 기록한다.

.codex/agents/code_reviewer.toml

@@ -1,6 +1,6 @@
 name = "code_reviewer"
 description = "Read-only DevLog code reviewer focused on correctness, regressions, scope drift, and missing verification."
-model = "gpt-5.3-codex-spark"
+model = "gpt-5.6-sol"
 model_reasoning_effort = "xhigh"
 sandbox_mode = "read-only"
 developer_instructions = """

.codex/agents/designer.toml

@@ -0,0 +1,12 @@
+name = "designer"
+description = "Read-only DevLog SDD gate for Design Brief analysis, Spec acceptance criteria, verification, and minimum commit units."
+model = "gpt-5.6-sol"
+model_reasoning_effort = "xhigh"
+sandbox_mode = "read-only"
+developer_instructions = """
+Read AGENTS.md and .agents/roles.md before analysis.
+Act only as the Designer defined in .agents/roles.md.
+Analyze the provided Design Brief and current repository context without editing files or changing GitHub state.
+Do not run, launch, install, boot, or open the app or Simulator.
+Return exactly the Designer Result format from .agents/roles.md.
+"""

AGENTS.md

@@ -10,8 +10,9 @@
 | Task | Required document |
 | --- | --- |
 | Every task | `.agents/rules/general.md` |
-| Non-trivial planning, implementation, review, or verification | `.agents/roles.md` |
+| Non-trivial design, planning, implementation, review, or verification | `.agents/roles.md` |
 | Repeatable role-based execution | `.agents/workflows.md` |
+| Approved Spec required by a non-trivial workflow | `.agents/specs/README.md` |
 | Module boundaries, file ownership, layer dependencies, DI, repository/service contracts, external SDK placement, Widget flow, `StorePattern`, or architecture documentation | `.agents/rules/architecture.md` |
 | PR, review thread, commit, Xcode project, CI, verification, localization, release, or build tooling | `.agents/rules/project-workflows.md` |
 
@@ -23,5 +24,6 @@
 - For architecture work, also read `README.md` before editing.
 - For a delegated role, read `.agents/roles.md` and follow the assigned role section and output format.
 - Use `.agents/workflows.md` when the task matches one of its executable workflows.
+- For a non-trivial design or implementation workflow, create a `Design Brief`, obtain a `Designer Result`, and use an approved Spec before fixing the `Task Packet`.
 - If repository-local instructions conflict with global memory, follow the repository-local instructions.
 - Write DevLog PR and review text in Korean.