[OCaml] Org mode parser.
docs add commit cadence, amend policy, and authorship rules
- Commit after each individual feature is implemented - Only amend when changes concern same files and commit is unpushed - AI-authored code uses --author with agent name, effort level, and company email domain - Default branch is master (fix main references)
.kiro/steering/git.md
@@ -131,6 +131,7 @@
131
131
## General Git practices
132
132
133
133
* Keep commits atomic: one logical change per commit.
134
Added:
* Commit after each individual feature is implemented.
134
135
* Do not mix formatting changes with behavioral changes in the same
135
136
commit.
136
137
* Prefer rebase workflows to keep linear history on `master`.
@@ -138,3 +139,37 @@
138
139
* Do not commit generated files (build artifacts, `.merlin`, etc.).
139
140
* Do not commit editor-specific files unless shared tooling requires
140
141
them.
142
Added:
* Always amend the latest unpushed commit when the requested
143
Added:
modifications concern files already modified in that commit.
144
Added:
Otherwise, create a new commit.
145
Added:
146
Added:
## Authorship
147
Added:
148
Added:
When an AI agent produces code, authorship must be correctly
149
Added:
attributed in the commit metadata.
150
Added:
151
Added:
* **Author**: the AI agent that produced the changes. Use the format:
152
Added:
153
Added:
```
154
Added:
Agent-Name (effort-level) <noreply@company-domain>
155
Added:
```
156
Added:
157
Added:
Where `effort-level` reflects the reasoning or effort mode the
158
Added:
agent was operating under when it produced the changes (e.g.
159
Added:
`high`, `medium`, `standard`, or a model-specific indicator).
160
Added:
The email domain identifies the company developing the agent.
161
Added:
162
Added:
Example: `Kiro (high) <noreply@kiro.dev>`
163
Added:
164
Added:
* **Committer**: always the human who reviewed and accepted the
165
Added:
changes. Use the human's normal Git identity.
166
Added:
167
Added:
Set authorship with:
168
Added:
169
Added:
```sh
170
Added:
git commit --author="Kiro (high) <noreply@kiro.dev>" -m "..."
171
Added:
```
172
Added:
173
Added:
This ensures `git log` and `git blame` clearly distinguish
174
Added:
AI-generated code from human-written code, while the committer
175
Added:
field records who took responsibility for merging it.