docs: improve AI agent workflow and instruction framework

- strengthen agent workflow rules and commit/log ordering
- improve AI logging instructions and traceability
- add agent framework documents and task generation tooling
- keep repository workflow consistent for future AI-assisted tasks
This commit is contained in:
2026-03-16 02:00:18 +01:00
parent 0118ad9314
commit 9704d3ef5b
4 changed files with 98 additions and 0 deletions

View File

@@ -105,6 +105,12 @@ Mandatory rules:
3. If the task was driven by a meaningful prompt, also append an entry to `docs/ai-prompts.md`.
4. Logging is part of the task itself and must not be skipped.
5. The task is not complete until the logs are updated.
6. Logs must always be written **before creating a commit**.
7. The agent must ensure that the following files are updated and staged before any commit:
- `docs/ai-worklog.md`
- `docs/ai-prompts.md`
8. If a commit is created without the corresponding log entries, the task is considered incomplete and must be corrected.
9. Log entries must be part of the same commit whenever possible to maintain traceability between the code change and the AI task that produced it.
Each worklog entry must include:
- date