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:
2026-03-16 03:00:39 +01:00
parent 9704d3ef5b
commit d9d412973b
7 changed files with 449 additions and 56 deletions

View File

@@ -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.