this-is-enough 0.1.2 → 0.1.3

package/AGENTS.md

@@ -208,6 +208,12 @@ Architecture-impacting change criteria (MUST):
 - `reqs/INBOX.md` is for independent/external requests.
 - Do not mix them.
 
+10) Commit cadence rule
+- Use phase cadence as default (not requirement-end only).
+- Minimum: create at least one commit when completing each phase before marking that phase `DONE`.
+- During phase execution, create checkpoint commits at meaningful progress boundaries (e.g., completed ordered tasks or stable validation checkpoints).
+- Before pause/switch/interrupt transitions, make a checkpoint commit for resumability. If impossible, record reason explicitly in `VALIDATION_LOG.md`.
+
 ---
 
 ## Session Start Checklist (MUST)
@@ -298,6 +304,7 @@ For each `PHASE-XX`:
 1. write `phases/PHASE-XX/PLAN.md` with ordered tasks, validation checklist, exit criteria
 2. implement according to plan
 3. append evidence to `phases/PHASE-XX/VALIDATION_LOG.md`
+4. create checkpoint commits at meaningful progress boundaries
 
 ### D) Complete Phase (2 required + 2 conditional)
 A phase is `DONE` only when all required checks pass:
@@ -305,15 +312,17 @@ A phase is `DONE` only when all required checks pass:
 2. `STATUS.md` and `reqs/ACTIVE.md` are updated
 3. if architecture-impacting changes occurred, ADR is added/updated in `docs/adr/`
 4. if architecture-impacting changes occurred, `ARCHITECTURE.md` reflects the current design
+5. at least one phase-related commit exists before phase is marked `DONE`
 
 ### E) Pause or Block Current Requirement
 Use when scope split or dependency wait occurs.
 
 Steps:
 1. write checkpoint summary in current `VALIDATION_LOG.md`
-2. update `STATUS.md` to `PAUSED` or `BLOCKED`
-3. fill inactive-state record fields (`changed_at`, `reason`, `resume_condition`, `next_action`)
-4. remove `reqs/ACTIVE.md` to unlock
+2. create a resumable checkpoint commit (or record why not possible in `VALIDATION_LOG.md`)
+3. update `STATUS.md` to `PAUSED` or `BLOCKED`
+4. fill inactive-state record fields (`changed_at`, `reason`, `resume_condition`, `next_action`)
+5. remove `reqs/ACTIVE.md` to unlock
 
 ### F) Switch to Another Requirement
 Precondition:
@@ -354,9 +363,10 @@ Precondition:
 
 Steps:
 1. append a short checkpoint in current phase `VALIDATION_LOG.md`
-2. create `reqs/INTERRUPT.md` with interrupt metadata and narrow scope
-3. execute only interrupt scope and record validation evidence in `reqs/INTERRUPT.md`
-4. if scope exceeds timebox or becomes non-urgent, close interrupt and move work to normal pause/switch + `REQ-*` flow
+2. create a checkpoint commit before leaving current requirement context (or record why not possible in `VALIDATION_LOG.md`)
+3. create `reqs/INTERRUPT.md` with interrupt metadata and narrow scope
+4. execute only interrupt scope and record validation evidence in `reqs/INTERRUPT.md`
+5. if scope exceeds timebox or becomes non-urgent, close interrupt and move work to normal pause/switch + `REQ-*` flow
 
 ### J) Close Urgent Interrupt (Archive + Resume)
 Precondition:
@@ -554,3 +564,5 @@ ADR metadata for selective lookup (required for new ADRs):
 - do not leave `reqs/INTERRUPT.md` after interrupt close; archive it to `reqs/interrupts/`
 - do not duplicate interrupt detail logs in requirement `VALIDATION_LOG.md`; store details only in interrupt record
 - do not switch requirements without writing pause/block checkpoint + inactive-state record
+- do not mark a phase `DONE` without at least one phase-related commit
+- do not pause/switch/open interrupt with uncommitted transition-critical changes unless the reason is explicitly recorded in `VALIDATION_LOG.md`

package/README.md

@@ -55,6 +55,7 @@ node /path/to/this-is-enough/bin/cli.js init --mode existing --cwd /path/to/repo
 - `--dry-run` (변경 예정만 출력)
 - `--force` (기존 파일 덮어쓰기, `AGENTS.md`는 차이가 있으면 `--force` 없이도 백업 후 갱신)
 - `--yes` (호환용, 기본이 이미 non-interactive)
+- `.gitignore`에 `reqs/*` 규칙이 없으면 자동 추가
 
 ### `doctor`
 
@@ -94,6 +95,7 @@ node /path/to/this-is-enough/bin/cli.js upgrade --cwd /path/to/repo
 - 누락된 `docs/adr`, `reqs`, `reqs/interrupts` 생성
 - 누락된 `ARCHITECTURE.md`, `reqs/INBOX.md` 생성
 - `AGENTS.md`가 다르면 백업(`AGENTS.md.bak.<timestamp>`) 후 갱신
+- `.gitignore`에 `reqs/*` 규칙이 없으면 자동 추가
 
 ## Installed Structure
 

package/bin/cli.js

@@ -41,6 +41,7 @@ function resolveProjectPaths(cwd) {
   return {
     agentsPath: path.join(cwd, "AGENTS.md"),
     architecturePath: path.join(cwd, "ARCHITECTURE.md"),
+    gitignorePath: path.join(cwd, ".gitignore"),
     inboxPath: path.join(cwd, "reqs", "INBOX.md"),
     activePath: path.join(cwd, "reqs", "ACTIVE.md"),
     interruptPath: path.join(cwd, "reqs", "INTERRUPT.md"),
@@ -182,6 +183,35 @@ function syncCoreAgents(filePath, content, options, actions) {
   return { status: "replaced", backupPath };
 }
 
+function ensureGitignoreReqsRule(filePath, options, actions) {
+  const rule = "reqs/*";
+  const ruleRegex = /^\s*reqs\/\*(\s+#.*)?\s*$/m;
+
+  if (!fs.existsSync(filePath)) {
+    actions.push(`create ${filePath} with ${rule}`);
+    if (!options.dryRun) {
+      fs.writeFileSync(filePath, `${rule}\n`, "utf8");
+    }
+    return;
+  }
+
+  const current = fs.readFileSync(filePath, "utf8");
+  if (ruleRegex.test(current)) {
+    actions.push(`skip existing ${rule} in ${filePath}`);
+    return;
+  }
+
+  const normalized = current.replace(/\r\n/g, "\n");
+  const nextContent = normalized.endsWith("\n")
+    ? `${normalized}${rule}\n`
+    : `${normalized}\n${rule}\n`;
+
+  actions.push(`append ${rule} to ${filePath}`);
+  if (!options.dryRun) {
+    fs.writeFileSync(filePath, nextContent, "utf8");
+  }
+}
+
 function timestampForBackup() {
   const now = new Date();
   const p = (n) => String(n).padStart(2, "0");
@@ -220,6 +250,7 @@ function initProject(options) {
     ensureDir(dirPath, options, actions);
   }
 
+  ensureGitignoreReqsRule(paths.gitignorePath, options, actions);
   const agentsSyncResult = syncCoreAgents(paths.agentsPath, readTemplateAgents(), options, actions);
   writeFileIfNeeded(paths.architecturePath, ARCHITECTURE_TEMPLATE, options, actions);
   writeFileIfNeeded(paths.inboxPath, INBOX_TEMPLATE, options, actions);
@@ -407,6 +438,7 @@ function upgradeProject(options) {
   ensureDir(paths.adrDir, options, actions);
   ensureDir(paths.reqsDir, options, actions);
   ensureDir(paths.interruptsDir, options, actions);
+  ensureGitignoreReqsRule(paths.gitignorePath, options, actions);
 
   createFileIfMissing(paths.architecturePath, ARCHITECTURE_TEMPLATE, options, actions);
   createFileIfMissing(paths.inboxPath, INBOX_TEMPLATE, options, actions);

package/package.json

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