this-is-enough 0.1.0 → 0.1.2

package/AGENTS.md

@@ -90,15 +90,15 @@ Run once when adopting this workflow in a new repository.
 - `reqs/INTERRUPT.md` must not exist at bootstrap completion
 
 4) First requirement starts only after bootstrap
-- create `REQ-*` through lifecycle section `A) Create New Requirement`
-- confirm via section `B) Confirm Requirement` (`full` or `mini` mode)
+- create `REQ-*` through lifecycle section `A) Create New Requirement` (after first feedback gate)
+- confirm via section `B) Confirm Requirement` (after codebase-informed second feedback gate, then `full` or `mini` mode)
 
 ---
 
 ## Status Model (Requirement-Level)
 
 Allowed statuses:
-- `DRAFT`: requirement exists and is being drafted (lock is active)
+- `DRAFT`: requirement exists and is being drafted through layered feedback/specification (lock is active)
 - `ACTIVE`: confirmed and currently being executed (lock is active)
 - `PAUSED`: intentionally stopped to work on another requirement (lock not held)
 - `BLOCKED`: cannot progress due to external dependency (lock not held)
@@ -149,6 +149,9 @@ Definitions:
   - else announce no active requirement and that new creation is allowed
 
 5) Requirement confirmation rule
+- Before roadmap creation, two feedback gates are mandatory:
+  - Gate 1 (alignment): summarize user request and receive explicit confirmation that understanding is correct
+  - Gate 2 (specification): after codebase exploration and requirement concretization, receive explicit confirmation again
 - Requirement is confirmed by one of:
   - Full mode: `ROADMAP.md` exists.
   - Mini mode: `REQUEST.md` contains a `Mini Roadmap` section and all criteria below are `yes/no`-exactly satisfied:
@@ -266,24 +269,29 @@ Precondition:
 - `reqs/ACTIVE.md` does not exist
 
 Steps:
-1. create `reqs/REQ-XXXX-<slug>/`
-2. create `REQUEST.md`
-3. create `STATUS.md` with status `DRAFT`
-4. create `reqs/ACTIVE.md` pointing to this requirement with status `DRAFT`
-5. if sourced from `reqs/INBOX.md`, update that item status to `promoted`
+1. summarize the incoming requirement in plain language and list assumptions/open points
+2. request user feedback and obtain explicit alignment confirmation (Gate 1)
+3. if alignment is rejected, revise summary and repeat steps 1-2
+4. create `reqs/REQ-XXXX-<slug>/`
+5. create `REQUEST.md` with aligned scope baseline from Gate 1
+6. create `STATUS.md` with status `DRAFT`
+7. create `reqs/ACTIVE.md` pointing to this requirement with status `DRAFT`
+8. if sourced from `reqs/INBOX.md`, update that item status to `promoted`
 
 ### B) Confirm Requirement (`DRAFT` -> `ACTIVE`)
 Trigger:
-- one of:
-  - Full mode: `ROADMAP.md` created in active requirement
-  - Mini mode: `REQUEST.md` includes `Mini Roadmap` and meets all Mini criteria
+- active requirement is in `DRAFT` after Gate 1 alignment
 
 Steps:
-1. choose confirmation mode (`full` or `mini`)
-2. if `full`: create `ROADMAP.md` (phases, goals, acceptance)
-3. if `mini`: add `Mini Roadmap` in `REQUEST.md` (tasks + acceptance + criteria flags)
-4. update `STATUS.md` to `ACTIVE` and record `roadmap_mode: full|mini`
-5. update `reqs/ACTIVE.md` to `ACTIVE`
+1. perform deep codebase exploration for the requirement scope
+2. map impacted components/files, constraints, risks, and validation approach in `REQUEST.md`
+3. present the codebase-informed requirement specification to user and obtain explicit confirmation (Gate 2)
+4. if Gate 2 feedback requests changes, iterate steps 1-3 until confirmed
+5. choose confirmation mode (`full` or `mini`)
+6. if `full`: create `ROADMAP.md` (phases, goals, acceptance)
+7. if `mini`: add `Mini Roadmap` in `REQUEST.md` (tasks + acceptance + criteria flags)
+8. update `STATUS.md` to `ACTIVE` and record `roadmap_mode: full|mini`
+9. update `reqs/ACTIVE.md` to `ACTIVE`
 
 ### C) Execute Phase (loop)
 For each `PHASE-XX`:
@@ -526,6 +534,8 @@ ADR metadata for selective lookup (required for new ADRs):
 
 ## Prohibitions (MUST NOT)
 - do not create a new requirement while `reqs/ACTIVE.md` exists (except the explicit interrupt exception path)
+- do not create `REQ-*`/`REQUEST.md` before Gate 1 alignment feedback is explicitly confirmed by user
+- do not create `ROADMAP.md` or `REQUEST.md` Mini Roadmap before Gate 2 codebase-informed feedback is explicitly confirmed by user
 - do not treat requirement as confirmed without either:
   - `ROADMAP.md` (full mode), or
   - valid `REQUEST.md` Mini Roadmap that satisfies all Mini criteria (mini mode)

package/README.md

@@ -1,4 +1,4 @@
-# ThisIsEnough
+# This-Is-Enough
 
 가볍지만 실행 가능한 에이전트 작업 규칙을 프로젝트에 설치하는 CLI입니다.
 
@@ -53,7 +53,7 @@ node /path/to/this-is-enough/bin/cli.js init --mode existing --cwd /path/to/repo
 - `--mode new|existing`
 - `--cwd <path>` (기본값: 현재 디렉토리)
 - `--dry-run` (변경 예정만 출력)
-- `--force` (기존 파일 덮어쓰기)
+- `--force` (기존 파일 덮어쓰기, `AGENTS.md`는 차이가 있으면 `--force` 없이도 백업 후 갱신)
 - `--yes` (호환용, 기본이 이미 non-interactive)
 
 ### `doctor`

package/bin/cli.js

@@ -157,6 +157,31 @@ function createFileIfMissing(filePath, content, options, actions) {
   }
 }
 
+function syncCoreAgents(filePath, content, options, actions) {
+  if (!fs.existsSync(filePath)) {
+    actions.push(`create ${filePath}`);
+    if (!options.dryRun) {
+      fs.writeFileSync(filePath, content, "utf8");
+    }
+    return { status: "created", backupPath: null };
+  }
+
+  const current = fs.readFileSync(filePath, "utf8");
+  if (current === content) {
+    actions.push(`skip up-to-date ${filePath}`);
+    return { status: "up-to-date", backupPath: null };
+  }
+
+  const backupPath = `${filePath}.bak.${timestampForBackup()}`;
+  actions.push(`backup ${filePath} -> ${backupPath}`);
+  actions.push(`overwrite ${filePath}`);
+  if (!options.dryRun) {
+    fs.copyFileSync(filePath, backupPath);
+    fs.writeFileSync(filePath, content, "utf8");
+  }
+  return { status: "replaced", backupPath };
+}
+
 function timestampForBackup() {
   const now = new Date();
   const p = (n) => String(n).padStart(2, "0");
@@ -195,7 +220,7 @@ function initProject(options) {
     ensureDir(dirPath, options, actions);
   }
 
-  writeFileIfNeeded(paths.agentsPath, readTemplateAgents(), options, actions);
+  const agentsSyncResult = syncCoreAgents(paths.agentsPath, readTemplateAgents(), options, actions);
   writeFileIfNeeded(paths.architecturePath, ARCHITECTURE_TEMPLATE, options, actions);
   writeFileIfNeeded(paths.inboxPath, INBOX_TEMPLATE, options, actions);
 
@@ -243,6 +268,14 @@ function initProject(options) {
     }
   }
 
+  if (agentsSyncResult.status === "replaced") {
+    if (options.dryRun) {
+      info(`Note: existing AGENTS.md would be backed up to ${agentsSyncResult.backupPath} before replacement.`);
+    } else {
+      info(`Note: existing AGENTS.md was backed up to ${agentsSyncResult.backupPath} before replacement.`);
+    }
+  }
+
   info(options.dryRun ? "Init check complete." : "Init complete.");
 }
 
@@ -369,6 +402,7 @@ function upgradeProject(options) {
   const paths = resolveProjectPaths(options.cwd);
   const actions = [];
   const warnings = [];
+  let agentsBackupPath = null;
 
   ensureDir(paths.adrDir, options, actions);
   ensureDir(paths.reqsDir, options, actions);
@@ -392,6 +426,7 @@ function upgradeProject(options) {
       const backupPath = `${paths.agentsPath}.bak.${timestampForBackup()}`;
       actions.push(`backup ${paths.agentsPath} -> ${backupPath}`);
       actions.push(`overwrite ${paths.agentsPath}`);
+      agentsBackupPath = backupPath;
       if (!options.dryRun) {
         fs.copyFileSync(paths.agentsPath, backupPath);
         fs.writeFileSync(paths.agentsPath, templateAgents, "utf8");
@@ -430,6 +465,14 @@ function upgradeProject(options) {
     }
   }
 
+  if (agentsBackupPath) {
+    if (options.dryRun) {
+      info(`Note: existing AGENTS.md would be backed up to ${agentsBackupPath} before replacement.`);
+    } else {
+      info(`Note: existing AGENTS.md was backed up to ${agentsBackupPath} before replacement.`);
+    }
+  }
+
   info(options.dryRun ? "Upgrade check complete." : "Upgrade complete.");
   return 0;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "this-is-enough",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Install and bootstrap the ThisIsEnough AGENTS.md workflow.",
   "license": "MIT",
   "bin": {