feat: finalize AI logging framework and workflow
- align instructions, workflow rules, and task template with three-level logging - extend ai-task generation to support execution-log requirements - update worklog, prompt log, and execution log for the finalized framework - validate the framework with generator and project quality checks
This commit is contained in:
@@ -1,5 +1,3 @@
|
||||
|
||||
|
||||
# AGENT_WORKFLOW.md
|
||||
|
||||
AI Agent Operational Workflow
|
||||
@@ -19,6 +17,7 @@ This file complements:
|
||||
- `instructions-agent.md`
|
||||
- `docs/ai-worklog.md`
|
||||
- `docs/ai-prompts.md`
|
||||
- `docs/ai-execution-log.md`
|
||||
|
||||
---
|
||||
|
||||
@@ -39,8 +38,9 @@ The following operational order must be respected when executing any BUILD task.
|
||||
make fix
|
||||
make quality
|
||||
3. Update AI logs
|
||||
- docs/ai-worklog.md
|
||||
- docs/ai-execution-log.md
|
||||
- docs/ai-prompts.md
|
||||
- docs/ai-worklog.md
|
||||
4. Stage all modified files including logs
|
||||
5. Create commit
|
||||
6. Push only if explicitly requested
|
||||
@@ -141,7 +141,7 @@ Validation must pass before changes are considered complete.
|
||||
Goal:
|
||||
Record the AI activity for traceability.
|
||||
|
||||
Two log files must be updated.
|
||||
Three log files must be updated.
|
||||
|
||||
### Work Log
|
||||
|
||||
@@ -186,6 +186,24 @@ Record:
|
||||
|
||||
Do not store chain-of-thought reasoning.
|
||||
|
||||
### Execution Log
|
||||
|
||||
```
|
||||
docs/ai-execution-log.md
|
||||
```
|
||||
|
||||
Record the full visible execution trace including:
|
||||
|
||||
- Date (YYYY-MM-DD HH:MM)
|
||||
- Task ID
|
||||
- Agent
|
||||
- Task Type
|
||||
- Full prompt text
|
||||
- Agent todos
|
||||
- Execution report
|
||||
|
||||
The execution log preserves the complete operational record of the AI session.
|
||||
|
||||
---
|
||||
|
||||
# Task ID Coordination
|
||||
@@ -208,6 +226,7 @@ BUILD-20260316-002
|
||||
|
||||
The same Task ID must appear in:
|
||||
|
||||
- ai-execution-log.md
|
||||
- ai-prompts.md
|
||||
- ai-worklog.md
|
||||
|
||||
@@ -221,7 +240,7 @@ 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
|
||||
- docs/ai-execution-log.md, docs/ai-worklog.md and docs/ai-prompts.md are staged
|
||||
|
||||
Commits that omit required AI log entries violate the repository workflow rules.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user