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:
@@ -28,6 +28,28 @@ Every AI task must follow this sequence:
|
||||
|
||||
PLAN → REVIEW → BUILD → VALIDATE → LOG
|
||||
|
||||
---
|
||||
|
||||
# Execution Order (Strict)
|
||||
|
||||
The following operational order must be respected when executing any BUILD task.
|
||||
|
||||
1. Implement changes (BUILD)
|
||||
2. Run validation
|
||||
make fix
|
||||
make quality
|
||||
3. Update AI logs
|
||||
- docs/ai-worklog.md
|
||||
- docs/ai-prompts.md
|
||||
4. Stage all modified files including logs
|
||||
5. Create commit
|
||||
6. Push only if explicitly requested
|
||||
|
||||
Important rule:
|
||||
Logs must always be written **before creating a commit**. If log files are modified after a commit, the task is considered incomplete and must be corrected.
|
||||
|
||||
---
|
||||
|
||||
This sequence must not be skipped.
|
||||
|
||||
---
|
||||
@@ -195,6 +217,14 @@ The same Task ID must appear in:
|
||||
|
||||
Agents must **not commit or push automatically** unless explicitly instructed.
|
||||
|
||||
Before creating a commit the agent must ensure:
|
||||
|
||||
- validation has passed
|
||||
- AI logs have been written
|
||||
- docs/ai-worklog.md and docs/ai-prompts.md are staged
|
||||
|
||||
Commits that omit required AI log entries violate the repository workflow rules.
|
||||
|
||||
When commits are requested:
|
||||
|
||||
1. Validate repository state
|
||||
|
||||
Reference in New Issue
Block a user