Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
153 changes: 106 additions & 47 deletions .agents/roles.md

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions .agents/rules/general.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/`.

Expand Down
6 changes: 6 additions & 0 deletions .agents/rules/project-workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
50 changes: 50 additions & 0 deletions .agents/specs/823-pr-826-review-follow-up.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# PR #826 Review Follow-up

- Source: https://github.com/opficdev/DevLog_iOS/pull/826
- Approved Designer Result: PR #826의 수용된 review thread 4개에 대한 `Designer Result`
- User approval: 네 review thread 전체 수용, 개별 커밋, push, `반영 {커밋번호}` 답글, resolve 승인

## Constraints

- `Designer`와 `Code Reviewer`의 `gpt-5.6-sol`, `xhigh`, 정확한 `task_name` 유지
- 기존 `Lightweight` 역할의 Spark 우선 및 Luna 대체 정책 유지
- 앱 코드, Swift 테스트, Tuist, CI 동작, QALenz, app 또는 Simulator 실행 제외

## Alternatives and decision

- 활성 `Primary`가 Sol일 때 SDD Gate 생략 또는 다른 모델 대체 방안 제외
- Sol 동일 모델 허용을 정확한 `designer`, `code_reviewer` custom agent dispatch로 한정
- 단순 작업의 SDD 절차 강제 방안 제외

## Changed boundaries

- `.agents/roles.md`의 Sol `Primary`와 Sol 전용 SDD Gate 공존 규칙
- `.agents/workflows.md`의 비단순 작업 전용 SDD 흐름
- `.agents/specs/README.md`의 이슈 없는 Spec 이름
- `README.md`의 SDD 역할 흐름과 모델 안내

## Acceptance criteria

- [ ] Sol `Primary`에서도 정확한 `designer`, `code_reviewer` SDD Gate dispatch 허용
- [ ] 단순 작업의 `Task Packet` 경로와 비단순 작업의 SDD 흐름 분리
- [ ] 이슈 없는 요청의 Spec 이름 규칙 정의
- [ ] `README.md`의 흐름과 역할 표를 현재 SDD 규칙과 동기화
- [ ] 스레드별 독립 커밋, push, `반영 {커밋번호}` 답글, resolve 완료

## Verification

- Command: `git diff --check -- AGENTS.md .agents .codex/agents README.md`
- Evidence: 역할·모델·정확한 `task_name` 점검, Mermaid 흐름 대조, GraphQL `reviewThreads` 상태 확인

## Minimum commit units

1. Sol `Primary`와 SDD Gate 공존 규칙
2. 비단순 작업 전용 SDD protocol
3. 이슈 없는 Spec 이름 규칙
4. `README.md` SDD 흐름과 역할 표 동기화

## Execution constraints

- app or Simulator execution: 금지
- External writes: git commit, push, 승인된 review reply와 resolve만 허용
- CI or PR actions: PR 생성 또는 병합 금지
56 changes: 56 additions & 0 deletions .agents/specs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# DevLog Spec Format

`Designer Result`를 사용자가 승인한 뒤, Planner가 비단순 설계 또는 구현 작업마다 이 디렉터리에 Spec을 작성한다. 이슈 기반 작업은 `<issue-number>-<short-topic>.md`, 이슈 없는 사용자 요청은 `user-<YYYYMMDD>-<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`은 역할별 현재 작업 권한과 실제 검증 명령을 별도로 기록한다.
Loading
Loading