@donghyeonlee/jjamppong-harness 0.1.0

package/AGENTS.md

@@ -0,0 +1,77 @@
+# AGENTS.md
+
+## Scope
+
+This repository uses Jjamppong Harness, an AI work safety harness.
+
+The directory containing this file is the harness root.
+
+## Required Reads
+
+For any substantive task, read these first:
+
+```text
+harness/contracts/gate-contract-matrix.yaml
+harness/contracts/capability-catalog.yaml
+harness/contracts/task.schema.yaml
+harness/contracts/permission-decision.schema.yaml
+harness/rules/workflow.md
+harness/rules/rules.md
+harness/state/planning.md
+active task events.jsonl, if one exists
+active task task.yaml, if one exists
+```
+
+If required files are missing, stale, or contradictory, stop and run verify/doctor.
+
+## Permission Source Of Truth
+
+Permission is granted only by:
+
+```text
+harness/contracts/*.yaml
+active task events.jsonl
+PermissionDecision result
+```
+
+`gate-ledger.md` is a human-readable projection.
+
+`task.yaml` is a derived cache.
+
+This file may restrict behavior further, but it must not grant permission beyond contracts and canonical events.
+
+## Hard Rules
+
+- Use `vowline` for substantive work, including subagents.
+- Do not start with README or AGENTS rewrites before contracts/tests/verify are in place.
+- Install requests stop after install and verify. Do not continue into planning.
+- Product planning starts with `grill` before project file reads.
+- `research` comes after `grill`; web research is not live target access.
+- `plan_review completed` never unlocks implementation.
+- `module_structure` never creates folders.
+- `folder_skeleton` never creates code, tests, fixtures, runtime config, package files, live access, commit, or push.
+- Short approvals approve only the immediately preceding explicit gate question and named scope.
+- Missing or ambiguous capabilities are denied.
+- Product code belongs under `modules/` unless exact `file.write.outside_modules` approval exists.
+- Secrets are deny-by-default.
+- Package install, live target access, commit, and push each need separate explicit capability approval.
+- Harness-core changes in product tasks must become proposals, not live edits.
+- Doctor/update/repair are proposal-only by default for modified managed files.
+- Root `handoff.md` changes only when the user asks for handoff.
+
+## User Language
+
+Ask user-facing gate questions in the user's language.
+
+If the user writes Korean, ask in Korean and explain technical labels briefly in plain language.
+
+- Human-facing artifacts use the user's language.
+- Machine-readable artifacts keep stable schema keys.
+- Static templates may use Korean starter copy; agents write live human-facing artifacts in the current user's language when presenting or updating them.
+- This phase does not add lifecycle-level localization.
+
+## Git
+
+Do not run `git commit`, `git push`, PR, merge, tag, or release commands unless the user explicitly approves that exact action in the current chat.
+
+Before asking for git approval, show changed files and the exact operation.

package/CONTEXT.md

@@ -0,0 +1,51 @@
+# 짬뽕하네스 Context
+
+## Language
+
+**짬뽕하네스**:
+A private agent workflow harness that combines Matt Pocock planning skills, Superpowers execution planning, gstack review lenses, Compound Engineering learning, and vowline discipline.
+Avoid: calling the whole harness Matt Planning Harness or OuroSuper Harness.
+
+**Planning gate**:
+The mandatory pre-implementation sequence that every task must pass before execution.
+
+**Task artifact**:
+A file created under `harness/docs/tasks/active/<slug>/` while planning, reviewing, implementing, or verifying a task.
+
+**Event log**:
+The append-only canonical task record at `harness/docs/tasks/active/<slug>/events.jsonl`.
+This is the source of truth for gate questions, user answers, approval decisions, permission decisions, verification results, and archive events.
+
+**Gate ledger**:
+The human-readable projection at `harness/docs/tasks/active/<slug>/gate-ledger.md`.
+It helps people review decisions, but it does not grant permission by itself.
+
+**Task cache**:
+The compact derived state at `harness/docs/tasks/active/<slug>/task.yaml`.
+If it disagrees with `events.jsonl`, verification fails and `events.jsonl` wins.
+
+**Brief**:
+The task-specific summary at `harness/docs/tasks/active/<slug>/brief.md`. This is not the same as root `handoff.md`.
+
+**Writing plan**:
+A Superpowers implementation plan at `harness/docs/tasks/active/<slug>/writing-plan.md`.
+
+**Module**:
+Product or application code under `modules/`, created only after approved module structure exists.
+
+**Proposal**:
+A pending harness rule change under `proposals/`, used before changing live rules.
+
+**Archive summary**:
+The required cold-context summary at `archive-summary.md` before moving a task from `active/` to `archive/YYYY/MM/`.
+
+## Relationships
+
+- The event log records gate questions, user answers, approval decisions, and permission decisions.
+- `gate-ledger.md`, `task.yaml`, and `planning-pack.md` are projections or manifests derived from approved state.
+- The planning gate creates a PRD.
+- A PRD is decomposed into one or more local task issues.
+- The task issues inform the brief and writing plan.
+- The writing plan controls implementation.
+- Verification and Compound Engineering run after implementation.
+- Finished task artifacts move from `harness/docs/tasks/active/` to `harness/docs/tasks/archive/YYYY/MM/` only after `archive-summary.md` exists.

package/README.md

@@ -0,0 +1,85 @@
+# 짬뽕하네스
+
+AI가 바로 코드를 만들지 않고, **질문 -> 기획 -> 승인 -> 실행 -> 검증** 순서로 움직이게 하는 안전 하네스입니다.
+
+프로젝트 폴더에 하네스를 설치하면 Codex가 `AGENTS.md`와 `harness/` 규칙을 읽고, 사용자가 승인하지 않은 코드 작성, 테스트 생성, 패키지 설치, live access, commit, push를 하지 못하게 막습니다.
+
+## Codex에게 설치시키기
+
+Codex에게 아래처럼 말하면 됩니다.
+
+```text
+vibedong/jjamppong-harness.git 설치해줘.
+설치할 위치는 내가 말한 프로젝트 폴더를 사용해줘.
+설치 후 verify까지만 하고 멈춰.
+기존 .git과 origin은 보존해줘.
+```
+
+설치할 폴더는 Codex에게 말할 때 같이 지정하면 됩니다.
+
+## 설치 결과
+
+정상 설치되면 대상 폴더 바로 아래에 하네스 파일이 생깁니다.
+
+```text
+프로젝트 폴더/
+  AGENTS.md
+  README.md
+  CONTEXT.md
+  handoff.md
+  harness/
+  modules/
+  module-template/
+  proposals/
+  harness.lock.yaml
+```
+
+잘못된 설치입니다.
+
+```text
+프로젝트 폴더/jjamppong-harness/AGENTS.md
+프로젝트 폴더/ourosuper-harness/AGENTS.md
+```
+
+하네스는 하위 폴더에 들어가는 앱이 아니라, 프로젝트 루트에 펼쳐지는 작업 규칙입니다.
+
+## 자주 보이는 문구와 파일
+
+Gate id는 지금 어느 단계의 허락을 받는지 보여주는 이름표입니다.
+
+예를 들어 `Gate id: implementation`이 보이면 "이제 구현을 시작해도 되는지 묻는 단계"라는 뜻입니다.
+
+자주 보이는 예시는 `Gate id: planning`, `Gate id: implementation`, `Gate id: handoff`입니다.
+
+events.jsonl은 실제 승인 기록 원본입니다. 작업이 진행되면 events.jsonl에 새 줄이 추가될 수 있습니다. 이 파일이 바뀌는 것은 정상입니다. 다만 기존 기록을 마음대로 고쳐 쓰면 안 됩니다.
+
+gate-ledger.md는 사람이 읽기 쉽게 정리한 승인 기록입니다. AI가 상황 파악용으로 읽을 수는 있지만, 권한 판단의 원본은 `events.jsonl`입니다.
+
+task.yaml은 현재 상태를 빠르게 읽는 요약 파일입니다. 이것도 권한 원본은 아닙니다.
+
+handoff.md는 새 채팅으로 넘길 상태 요약입니다. handoff.md를 만든 뒤에는 다음 채팅에 붙여넣을 프롬프트를 채팅 응답으로 출력합니다.
+
+## 하네스가 막는 것
+
+- 설치만 했는데 PRD, issue, module, code를 바로 만드는 것
+- 사용자 의도 질문 전에 기존 폴더부터 읽는 것
+- plan review가 끝났다는 이유로 구현을 시작하는 것
+- 폴더 구조 승인만 받고 코드, 테스트, fixture까지 만드는 것
+- "좋아"를 넓은 승인으로 해석하는 것
+- live target access, package install, commit, push를 묵시적으로 실행하는 것
+
+## 실제 작업 흐름
+
+설치 후 새 작업을 시작하면 Codex는 보통 이렇게 움직여야 합니다.
+
+```text
+1. 사용자 의도 질문
+2. 필요한 자료조사
+3. PRD / issue / module structure / writing plan 작성
+4. plan review
+5. 실제 작업 범위와 권한을 다시 질문
+6. 승인된 범위만 구현
+7. verify 후 사용자 확인
+```
+
+좋은 문서가 아니라, AI가 통과해야 하는 문을 만든다.

package/bin/jjamppong.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { installHarness } = require('../harness/installer/install');
+const { verifyRoot } = require('../harness/verify/verify');
+const { diagnose } = require('../harness/doctor/doctor');
+const { decide } = require('../harness/permission/permission-decision');
+
+function parseArgs(argv) {
+  const positional = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (!token.startsWith('--')) {
+      positional.push(token);
+      continue;
+    }
+    const key = token.slice(2);
+    const next = argv[i + 1];
+    if (!next || next.startsWith('--')) {
+      flags[key] = true;
+    } else {
+      flags[key] = next;
+      i += 1;
+    }
+  }
+  return { positional, flags };
+}
+
+function printHelp() {
+  process.stdout.write(`Usage:
+  jjamppong install --target <path> [--template <path>]
+  jjamppong verify --target <path> [--json]
+  jjamppong doctor --target <path> [--proposal] [--json]
+  jjamppong perm decide --repo-root <path> --capability <capability> [--path <path>]
+
+Safety defaults:
+  install stops after install/verify;
+  no planning, package install, GitHub repo creation, commit, or push.
+`);
+}
+
+function main() {
+  const { positional, flags } = parseArgs(process.argv.slice(2));
+  const command = positional[0];
+
+  if (!command || flags.help || command === 'help') {
+    printHelp();
+    return;
+  }
+
+  if (command === 'install') {
+    const target = flags.target || positional[1];
+    if (!target) throw new Error('install requires --target <path>.');
+    const result = installHarness({
+      target,
+      templateRoot: flags.template ? path.resolve(flags.template) : path.resolve(__dirname, '..'),
+      version: require('../package.json').version,
+    });
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+
+  if (command === 'verify') {
+    const target = flags.target || positional[1] || process.cwd();
+    const result = verifyRoot(target);
+    if (flags.json) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    } else if (result.ok) {
+      process.stdout.write(`verify passed for ${result.root}\n`);
+    } else {
+      process.stdout.write(`verify failed for ${result.root}\n`);
+      for (const failure of result.failures) {
+        process.stdout.write(`FAIL ${failure.id}: ${failure.message}\n`);
+      }
+    }
+    process.exitCode = result.ok ? 0 : 1;
+    return;
+  }
+
+  if (command === 'doctor') {
+    const target = flags.target || positional[1] || process.cwd();
+    const result = diagnose(target, { proposal: Boolean(flags.proposal) });
+    if (flags.json) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    } else if (result.ok) {
+      process.stdout.write(`doctor found no P0 issues for ${result.root}\n`);
+    } else {
+      process.stdout.write(`doctor found ${result.failures.length} issue(s) for ${result.root}\n`);
+      for (const failure of result.failures) {
+        process.stdout.write(`- ${failure.id}: ${failure.next_action}\n`);
+      }
+      if (result.proposal_path) process.stdout.write(`proposal: ${result.proposal_path}\n`);
+    }
+    process.exitCode = result.ok ? 0 : 1;
+    return;
+  }
+
+  if (command === 'perm' && positional[1] === 'decide') {
+    const result = decide({
+      repoRoot: flags['repo-root'] || process.cwd(),
+      taskDir: flags.task,
+      eventsPath: flags.events,
+      taskYamlPath: flags['task-yaml'],
+      capability: flags.capability,
+      path: flags.path,
+      action: flags.action,
+    });
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    process.exitCode = result.decision === 'allow' ? 0 : 2;
+    return;
+  }
+
+  throw new Error(`Unknown command: ${positional.join(' ')}`);
+}
+
+try {
+  main();
+} catch (error) {
+  process.stderr.write(`ERROR ${error.message}\n`);
+  process.exitCode = 1;
+}

package/handoff.md

@@ -0,0 +1,13 @@
+# Global Handoff
+
+Root `handoff.md` is the global next-chat/context-transfer file.
+
+Write this file in the user's language when the user requests a handoff.
+
+Include status summary, current decisions, remaining work, risks, and files the next agent should read.
+
+Do not store the next-chat restart prompt here by default. Return that prompt in the chat response after creating the handoff.
+
+Task-specific summaries belong under:
+
+`harness/docs/tasks/active/<YYYY-MM-DD-short-topic>/brief.md`

package/harness/contracts/capability-catalog.yaml

@@ -0,0 +1,128 @@
+version: 0.1.0
+name: jjamppong-harness-capability-catalog
+principle: >-
+  Permissions are capability-based. File writes are only one capability.
+  Reads, commands, network, package operations, git operations, secrets,
+  installer actions, harness-core changes, and parallel writes are all explicit capabilities.
+
+defaults:
+  missing_capability: deny
+  ambiguous_scope: deny
+  short_approval_expansion: deny
+
+capabilities:
+  file.read.project:
+    description: Read non-secret files inside the project root.
+    default: denied_before_grill
+    unlock: research_after_grill
+  file.read.archive:
+    description: Read archived task details.
+    default: index_only
+    rule: Read index and archive-summary first; raw archive logs require relevance justification.
+  file.read.raw_artifact:
+    description: Read large raw artifacts such as HTML dumps, crawl outputs, logs.
+    default: deny
+  file.read.secret:
+    description: Read credentials, tokens, cookies, private keys, .env files, service accounts.
+    default: deny
+  file.write.task_artifact:
+    description: Write current task artifacts under active task directory.
+    default: gated
+  file.write.module:
+    description: Write approved files under approved modules/<module> paths.
+    default: deny_until_implementation
+  file.write.folder_skeleton:
+    description: Create approved empty module folders and approved non-executable placeholder docs.
+    default: deny_until_folder_skeleton
+  file.write.outside_modules:
+    description: Write product integration files outside modules/.
+    default: deny
+    requires: outside_modules_write capability approval with exact paths
+  file.write.harness_core:
+    description: Write AGENTS.md, harness/rules/**, harness/contracts/**, installer, package, plugin rules.
+    default: deny_in_product_task
+    requires: template_maintenance or harness_update task
+  file.delete:
+    description: Delete files.
+    default: deny_unless_explicit
+  file.move:
+    description: Move or rename files.
+    default: deny_unless_explicit
+  file.symlink:
+    description: Create symlink, junction, hardlink, shortcut, mount-like indirection.
+    default: deny
+
+  exec.readonly_info:
+    description: Non-mutating commands such as git status, listing files, version checks.
+    default: allowed_after_relevant_gate
+  exec.test:
+    description: Run tests.
+    default: deny_until_verification_or_plan
+  exec.build:
+    description: Run build commands.
+    default: deny_until_approved
+  exec.mutating:
+    description: Commands that modify filesystem state.
+    default: deny
+  exec.destructive:
+    description: rm -rf, git clean, force reset, destructive DB operations.
+    default: deny
+  exec.networked:
+    description: Command that contacts network.
+    default: deny_unless_network_capability
+
+  network.web_research:
+    description: General web search or documentation lookup.
+    default: allowed_in_research_with_citation
+  network.live_target:
+    description: Actual target site/API access, including read-only requests, crawl, download, login page, API calls.
+    default: deny_until_live_access_approval
+  network.package_registry:
+    description: npm/pip/apt/other package registry access.
+    default: deny_until_package_install_approval
+  network.authenticated:
+    description: Authenticated network access using token, cookie, account, API key, login.
+    default: deny
+
+  package.install:
+    description: Install or change dependencies, lockfiles, package manager state, runtime packages.
+    default: deny
+  package.update:
+    description: Update dependency versions.
+    default: deny
+
+  git.commit:
+    description: Create a git commit.
+    default: deny_until_git_commit_approval
+  git.push:
+    description: Push to remote.
+    default: deny_until_git_push_approval
+  git.remote_change:
+    description: Add/change/remove git remote.
+    default: deny_unless_install_or_explicit
+
+  installer.install:
+    description: Install harness files.
+    default: allowed_only_in_install_task
+  installer.update:
+    description: Update installed harness files.
+    default: proposal_only_if_modified
+  installer.repair:
+    description: Repair installed harness files.
+    default: proposal_only_if_modified
+  installer.rollback:
+    description: Roll back installer changes using manifest.
+    default: explicit_only
+
+  harness.core_change:
+    description: Change harness core rules/contracts/installer/plugins.
+    default: deny_in_product_repo
+    requires: template_maintenance task and proposal approval
+  project.policy_change:
+    description: Change project-local harness overlay policy.
+    default: proposal_required
+
+  parallel.write:
+    description: Allow multiple active writers/tasks.
+    default: deny
+    requires: explicit_parallel_active_task_approval

package/harness/contracts/gate-contract-matrix.yaml

@@ -0,0 +1,188 @@
+version: 0.1.0
+name: jjamppong-harness-gate-contract-matrix
+notes:
+  - Workflow gates are not the same as capability approvals.
+  - Capability approvals may be embedded in implementation approval or separate exact-scope gates.
+  - Missing or ambiguous capabilities are denied.
+
+gates:
+  install:
+    user_label: 설치만 하기
+    previous: []
+    reads: [file.read.project]
+    writes: [installer.install]
+    required_artifacts: [harness.lock.yaml, install-summary]
+    forbidden: [project_planning_start, prd, issues, module_creation, code, tests, fixtures, live_access, git.commit, git.push]
+    transition_to: [stop, intake]
+    verify_ids: [T001, T002, T003]
+
+  intake:
+    user_label: 요청 기록
+    previous: [install_or_existing_project]
+    reads: [user_prompt]
+    writes: [task_artifact]
+    required_artifacts: [task.yaml, events.jsonl]
+    forbidden: [project_file_read, prd, module_creation, code, tests, live_access]
+    transition_to: [grill]
+    verify_ids: [T004]
+
+  grill:
+    user_label: 압박 질문
+    previous: [intake]
+    reads: [user_prompt, prior_user_answers]
+    writes: [planning/01-grill-summary.md, events.jsonl]
+    required_artifacts: [grill-summary, gate_question_events, user_answer_events]
+    forbidden: [project_scan_before_approval, docs_first, prd, issues, folders, code, tests, live_access]
+    transition_to: [research]
+    verify_ids: [T005, T006, T007]
+
+  research:
+    aliases: [evidence_check]
+    user_label: 자료조사 / 근거 확인
+    previous: [grill]
+    reads: [file.read.project, network.web_research]
+    writes: [planning/02-research-summary.md, events.jsonl]
+    required_artifacts: [research-summary]
+    forbidden: [network.live_target, package.install, code, tests, folders, prd_approval_without_user]
+    transition_to: [grill, compound_lookup, prd]
+    verify_ids: [T008, T009, T022, T023]
+
+  compound_lookup:
+    user_label: 이전 배운 점 확인
+    previous: [research]
+    reads: [knowledge.index, archive.summary, selected_top_learnings]
+    writes: [planning/02b-compound-lookup.md]
+    required_artifacts: [compound-lookup-summary]
+    forbidden: [archive_raw_default_read, past_learning_over_current_intent, unapproved_proposal_as_rule]
+    transition_to: [prd]
+    verify_ids: [T040]
+
+  architecture_orientation:
+    user_label: 기술 구성 설명
+    previous: [grill]
+    reads: [planning_context]
+    writes: [planning/02c-architecture-orientation.md]
+    required_artifacts: [architecture-orientation]
+    forbidden: [technology_forcing_without_user, code]
+    transition_to: [prd]
+
+  prd:
+    user_label: PRD / 기획 확정
+    previous: [grill, research]
+    writes: [planning/03-prd.md, planning-pack.md]
+    required_artifacts: [approved_prd]
+    forbidden: [implementation, code, tests, folder_creation]
+    transition_to: [issues]
+    verify_ids: [T011]
+
+  issues:
+    user_label: 이슈 나누기
+    previous: [prd]
+    writes: [planning/04-issues.md, planning-pack.md]
+    required_artifacts: [approved_issues]
+    forbidden: [code, tests, live_access]
+    transition_to: [module_structure]
+
+  module_structure:
+    user_label: 구조 나누기
+    previous: [prd, issues]
+    writes: [planning/05-module-structure.md, module_structure_state_projection]
+    required_artifacts: [approved_module_structure]
+    forbidden: [folder_creation, code, tests, fixtures, live_access]
+    transition_to: [writing_plan, folder_skeleton]
+    verify_ids: [T016]
+
+  writing_plan:
+    user_label: 구현계획 쓰기
+    previous: [issues, module_structure]
+    reads: [planning/00-current-planning-context.md, prd, issues, module_structure]
+    writes: [planning/06-writing-plan.md]
+    required_artifacts: [writing_plan]
+    forbidden: [code, tests, fixtures, live_access]
+    transition_to: [plan_review]
+    verify_ids: [T010]
+
+  plan_review:
+    user_label: 계획 리뷰
+    previous: [writing_plan]
+    writes: [planning/07-plan-review.md]
+    required_artifacts: [plan_review]
+    forbidden: [implementation_unlock, code, tests, fixtures, live_access]
+    transition_to: [folder_skeleton, implementation]
+    verify_ids: [T010]
+
+  folder_skeleton:
+    user_label: 빈 폴더틀 승인
+    previous: [module_structure]
+    writes: [approved_empty_dirs, approved_gitkeep, approved_placeholder_docs]
+    required_artifacts: [folder_skeleton_approval, skeleton_log]
+    forbidden: [executable_source, tests, fixtures, runtime_config, package_files, live_access]
+    transition_to: [implementation, writing_plan]
+    verify_ids: [T017, T018]
+
+  implementation:
+    user_label: 진짜 작업 승인
+    previous: [plan_review]
+    writes: [implementation-approval.md, events.jsonl]
+    required_artifacts: [permission_decision_scope, artifact_hash_snapshot]
+    effect_capabilities: [file.write.module, exec.test, exec.build, package.install, network.live_target, git.commit, git.push]
+    forbidden: [implicit_capability, approval_scope_expansion]
+    transition_to: [work]
+    verify_ids: [T012, T013, T014, T015]
+
+  work:
+    user_label: 작업 실행
+    previous: [implementation]
+    writes: [approved_target_paths]
+    required_artifacts: [permission_decisions, implementation_log]
+    forbidden: [scope_creep, unapproved_outside_modules, unapproved_live_access, unapproved_git, unapproved_package_install]
+    transition_to: [verification]
+    verify_ids: [T020, T021, T022, T024, T025, T026, T027, T028]
+
+  verification:
+    user_label: 검증
+    previous: [work]
+    writes: [verification.md]
+    required_artifacts: [commands_run, expected_actual, exit_codes, risk_status]
+    forbidden: [new_feature_work]
+    transition_to: [acceptance, compound_capture]
+
+  acceptance:
+    user_label: 사용자 확인
+    previous: [verification]
+    writes: [acceptance.md]
+    required_artifacts: [accepted_or_deferred_or_blocked]
+    forbidden: [silent_archive_without_acceptance_status]
+    transition_to: [compound_capture, archive]
+
+  compound_capture:
+    user_label: 배운 점 정리
+    previous: [verification]
+    writes: [learning-capture.md, knowledge_draft]
+    required_artifacts: [learning_capture]
+    forbidden: [live_rule_edit]
+    transition_to: [compound_review, archive]
+    verify_ids: [T039]
+
+  proposal:
+    user_label: 개선 제안
+    previous: [compound_review_or_user_request]
+    writes: [proposals/active/*.md]
+    required_artifacts: [proposal_doc]
+    forbidden: [live_harness_core_change_without_approval]
+    transition_to: [template_maintenance, archive]
+    verify_ids: [T031, T032]
+
+  archive:
+    user_label: 완료 보관
+    previous: [verification]
+    writes: [archive-summary.md, tasks/index.md, archive_move]
+    required_artifacts: [archive_summary]
+    forbidden: [active_left_dirty, raw_archive_as_hot_context]
+
+  handoff:
+    user_label: 새 채팅 인계
+    previous: [user_requested]
+    writes: [handoff.md]
+    required_artifacts: [handoff_summary]
+    forbidden: [automatic_handoff_update]