Skip to content

Commit 2b541ca

Browse files
Add context-first development principle to Agentic development
Establishes the flow: intention → docs → README → code. Code echoes the docs, not the other way around. Links to README-Driven Context and explains why this matters for agentic development at scale.
1 parent e25dc16 commit 2b541ca

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

docs/Ways-of-Working/Principles.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,26 @@ LLM tokens are not the right tool for work that has a deterministic answer. Use
7070
- **Integration** — the agent's ability to act on a platform as if it were human. GitHub, the editor, the terminal.
7171
- **Sensoring** — the agent's ability to notice that it is needed. Webhooks, scheduled checks, signals from the platform.
7272

73+
### Context-first development
74+
75+
An echo of platform engineering's "a product starts with a README." Every change flows through context before it touches code:
76+
77+
```text
78+
Intention of change → Update documentation → Update README → Update code
79+
```
80+
81+
Code echoes the docs, not the other way around. The README and the docs are the **specification**. If a change isn't reflected in context first, the code has no contract to implement against — and agents have nothing to read.
82+
83+
This means:
84+
85+
- A new feature starts as a documented intent (issue, README update, or docs change) before any code is written.
86+
- A refactor updates the relevant documentation **first**, then the code follows to match.
87+
- If the docs and the code disagree, the docs are wrong — fix the docs, then fix the code to match.
88+
89+
This is what makes agentic development work at scale. Agents read context. If the context is stale or missing, the agent builds the wrong thing. Keeping context ahead of code is how we stay in control.
90+
91+
See [README-Driven Context](Readme-Driven-Context.md).
92+
7393
## Getting Things Done
7494

7595
From David Allen's [GTD](https://gettingthingsdone.com/). If something is only in your head:

0 commit comments

Comments
 (0)