# devloop   

 AGENTS.md CONCEPTS.mdrepo owner  CONCEPTS.md 

---

## 1. 



```
enter       (lint/test)  commit/ PR   merge  
```

devloop ** + Board**Board AI ****""guest workspace session cwd subproject ** shell cwd repo**

---

## 2. 

   hook / script  

| # |  |  |  |  |
|---|----|------|--------|---------|
| 0 | session  | `SessionStart` | `sessionstart_init` | Board  session itemsReferences / subprojects subproject  AGENTS.md `watchPaths`workspace  |
| 1 | enter  | `cd`  `CwdChanged` | `cwdchanged_enter` |  repo  `active.json` owner enter  |
| 2 |  | `UserPromptSubmit` | `userprompt_inject` | Board / session/turn/event itemsui_only  prompt`PostCompact`  items AGENTS.md  `FileChanged`  `filechanged_refs`  |
| 3 |  | `PreToolUse` | `tool_call_timeline` owner / branch merged / requirements / checkout owner / worktree add / add-all / workspace cwd / pytest / pip / precommit gate |  repo  `.devloop/tool-calls.jsonl` deny  fail-open |
| 3' |  | `PostToolUse` / `PostToolUseFailure` | `tool_call_timeline``posttool_git_refresh` | git **** repo  branch  validation gate |
| 4 |  | validate skill / lifecycle gate | `run_validate`  `normalize  lint  test` |  component  check lint  + test  |
| 5 |  / PR | `/gcam` `/gcamp` `/gcampr` | `commit_flow`PLAN banner  |  cut  `origin/`base  `--file`  staging PR  `poll_pr_status` |
| 5b |  PR/MR rebase | `smart_rebase.sh start/continue/finish` | `domain.rebase`worktree-local transaction | start  source SHAfinish  `force-with-lease` |
| 6 |  merge | monitors  | `poll_pr_status` |  `pr.json`    in-flightBoard turn item  |
| 7 | merge  | AI  |  |  inactive 1  `origin/`  |

### 

```
cut off origin/  healthy push+PR in-flight  merge(AI ) inactive
                                                                                     
            cut off origin/  
```

 /  CONCEPTS.md

### 

- **repo ** 1 / 3 / 4 / 5  `--repo`  cwd   `active.json` guard `-C` > cd  > cwd CONCEPTS.md repo 
- **tool-call ** 3 / 3'devloop  tool  read/write loop 
- **** 2  3 / 5 protected / healthy / in-flight / inactive `pr.json`  bool CONCEPTS.md
- **owner ** 3 / 3'  acquire + enforce session  checkoutguest  worktreeenter /  CONCEPTS.mdOwner / guest session

---

## 3.  why

- ** merge  AI **merge devloop  merge PLAN 
- ** commit **lint/test  + validation  gate  opt-in`precommit_gate`""docs hotfix in-flight 
- **" bool"** 6/7  AI  merge bool  `pr.json` 
- ** guard  fail-open**guard  guard `hook_io` runner