Skip to content

Commit 314be79

Browse files
committed
Improve README opening for agent workflow
1 parent 9e15f6b commit 314be79

1 file changed

Lines changed: 18 additions & 7 deletions

File tree

README.md

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,26 @@ Block Enforceable Architectural Representation
99
Agents can generate large amounts of code very quickly.
1010
The dangerous changes are often structural: new dependencies, widened boundaries, and new authority surfaces.
1111

12-
BEAR makes those architectural changes explicit and visible in CI.
13-
14-
BEAR is a deterministic governance CLI and CI gate for agent-driven backend development.
12+
BEAR is a deterministic governance CLI and CI gate that makes those structural changes explicit and visible in CI.
1513

1614
Demo repo: [bear-account-demo](https://github.com/rore/bear-account-demo)
1715

18-
When boundary authority changes, the agent updates BEAR IR first, BEAR compiles deterministic structural constraints, and then implementation code fits inside those constraints.
19-
The result is a stable, machine-parseable governance signal: either green, or a precise failure with a remediation hint.
16+
## How BEAR works (10 seconds)
17+
18+
1. The agent updates BEAR IR when boundary authority must change.
19+
2. `bear compile` materializes deterministic structural constraints from that IR.
20+
3. The agent implements code inside those constraints.
21+
4. `check` and `pr-check` surface drift, bypass, and boundary expansion in CI.
22+
23+
## Example governance signal
2024

25+
```text
26+
BEAR Decision: REVIEW REQUIRED
27+
MODE=observe DECISION=review-required BASE=<target-base>
28+
29+
CHECK exit=0 code=- classes=[CI_NO_STRUCTURAL_CHANGE]
30+
PR-CHECK exit=5 code=BOUNDARY_EXPANSION classes=[CI_BOUNDARY_EXPANSION]
31+
```
2132
```mermaid
2233
%% id: bear-workflow-v1
2334
flowchart LR
@@ -112,10 +123,10 @@ macOS/Linux (bash/zsh):
112123
./.bear/tools/bear-cli/bin/bear --help
113124
```
114125

115-
3. Let your agent implement specs.
126+
3. Let your agent update IR first if boundary authority changes, then implement the specs inside the generated constraints.
116127

117128
```text
118-
Implement the specs.
129+
Implement the specs. Update BEAR IR first if the boundary must change.
119130
```
120131

121132
4. Compile deterministic generated artifacts.

0 commit comments

Comments
 (0)