Saky
6195f7b8a3
- add standardized AI BUILD ENTRY and AI PLAN ENTRY format - improve consistency of AI development logs - update instructions-agent.md
58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# AI Worklog
|
|
|
|
This file records important AI-assisted development actions.
|
|
|
|
Each entry should include:
|
|
- date
|
|
- task type (plan/build)
|
|
- objective
|
|
- files inspected or modified
|
|
- key decisions
|
|
- validation commands executed
|
|
- result
|
|
- open issues (if any)
|
|
|
|
Entries must be concise and chronological.
|
|
|
|
## 2026-03-15 - build
|
|
|
|
- objective: Replace the temporary history debug overlay with a dedicated history mode in the terminal UI.
|
|
- files modified: `src/app/ui.py`, `tests/test_ui.py`
|
|
- key decisions: Keep `b` and `f` unchanged, add separate history-mode selection state inside the UI, hide the tree while history mode is active, and use Enter to select a history entry and return to the tree view.
|
|
- validation: `make fix`, `make quality`
|
|
- result: History mode now shows only the history list, supports Up/Down selection, allows Enter to jump to a prior directory, and exits cleanly back to normal navigation.
|
|
- open issues: None.
|
|
|
|
## 2026-03-15 - build
|
|
|
|
- objective: Introduce mandatory AI logging rules and document the repository logging workflow.
|
|
- files modified: `instructions-agent.md`, `docs/ai-worklog.md`, `docs/ai-prompts.md`
|
|
- key decisions: Require AI agents to log significant plan and build tasks, preserve separate logs for work performed and prompts received, and keep entries concise and user-facing.
|
|
- validation: not run
|
|
- result: The repository now defines mandatory AI logging in `instructions-agent.md` and includes dedicated log files for AI work history and prompt summaries.
|
|
- open issues: None.
|
|
|
|
### AI BUILD ENTRY
|
|
Date: 2026-03-15
|
|
Task: build
|
|
Objective: Record the introduction of the standard AI log entry format and improve AI logging consistency.
|
|
|
|
Files Modified:
|
|
- `instructions-agent.md`
|
|
- `docs/ai-worklog.md`
|
|
- `docs/ai-prompts.md`
|
|
|
|
Key Decisions:
|
|
- Add a dedicated "Standard AI Log Entry Format" section to define `AI BUILD ENTRY` and `AI PLAN ENTRY` blocks.
|
|
- Use the new standardized format for this worklog update to establish the pattern in the repository logs.
|
|
|
|
Validation:
|
|
- make fix (passed)
|
|
- make quality (passed)
|
|
|
|
Result:
|
|
- The repository now documents a standard AI log entry format and uses it to improve consistency of AI-assisted development logs.
|
|
|
|
Open Issues:
|
|
- None.
|