Saky
9704d3ef5b
- 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
333 lines
7.2 KiB
Markdown
333 lines
7.2 KiB
Markdown
# AI Worklog
|
||
|
||
This file records important AI‑assisted development actions.
|
||
|
||
The log is designed for long‑term traceability of AI‑driven development.
|
||
|
||
Each entry must include:
|
||
- Date (YYYY-MM-DD HH:MM)
|
||
- Task ID
|
||
- Agent
|
||
- Task type (plan/build)
|
||
- Objective
|
||
- Scope
|
||
- Files Modified / Files Inspected
|
||
- Key Decisions or Proposed Changes
|
||
- Validation
|
||
- Result
|
||
- Open Issues
|
||
|
||
Entries must remain chronological.
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 18:10
|
||
Task ID: BUILD-20260315-001
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Replace the temporary history debug overlay with a dedicated history mode in the terminal UI.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
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.
|
||
- 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 and allows navigation and selection of past directories.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-16 01:45
|
||
Task ID: BUILD-20260316-004
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Finalize and publish the AI agent workflow, instruction framework, and task tooling updates.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- AGENT.md
|
||
- AGENT_WORKFLOW.md
|
||
- AI_TASK_TEMPLATE.md
|
||
- scripts/ai-task
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- AGENT_WORKFLOW.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Strengthen commit and logging order rules so AI logs must be written before creating commits.
|
||
- Keep the new agent framework documents and task tooling aligned with the repository validation and traceability model.
|
||
- Publish the previously prepared framework files together with the finalized logging guidance on the current branch.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- The repository now has a finalized AI instruction and workflow framework, standardized task tooling, and matching logs documenting the framework rollout.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 19:30
|
||
Task ID: BUILD-20260315-002
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Introduce mandatory AI logging rules and repository logging workflow.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Require AI agents to log plan and build tasks.
|
||
- Separate logs for work results and prompts.
|
||
- Keep entries concise and user‑focused.
|
||
|
||
Validation:
|
||
- not run
|
||
|
||
Result:
|
||
- Repository now enforces AI logging via instructions-agent.md.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 20:05
|
||
Task ID: BUILD-20260315-003
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Introduce the standard AI log entry format and improve logging consistency.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Define AI BUILD ENTRY and AI PLAN ENTRY blocks.
|
||
- Standardize structure for long‑term repository traceability.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Repository now uses a standardized AI logging format.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 21:40
|
||
Task ID: BUILD-20260315-004
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Improve keyboard navigation behavior in the terminal UI for tree mode.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Files Modified:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Key Decisions:
|
||
- Right expands collapsed directories and enters expanded directories.
|
||
- Left collapses expanded directories or navigates to the parent directory.
|
||
- Enter confirms the selected path.
|
||
- ESC cancels and returns to the original directory.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Tree navigation semantics improved with clearer expand, enter, and cancel behavior.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 22:25
|
||
Task ID: BUILD-20260315-005
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Implement vertical scrolling so the selected entry always remains visible.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Files Modified:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Key Decisions:
|
||
- Introduce scroll offsets in the UI state.
|
||
- Clamp offsets to keep the selected row visible.
|
||
- Apply the same mechanism to history mode.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Tree and history views now scroll when navigating beyond the visible screen area.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-16 00:27
|
||
Task ID: BUILD-20260316-001
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Consolidate terminal UI navigation improvements and document updated behavior.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Maintain dedicated history mode.
|
||
- Refine tree-mode keyboard behavior.
|
||
- Keep UI logic isolated from navigator logic.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Terminal UI now includes history mode, improved navigation semantics, and reliable vertical scrolling.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-16 01:26
|
||
Task ID: BUILD-20260316-002
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Finalize the AI logging format system and align repository log files with the structured logging framework.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Require timestamped log entries with date and time, Task ID, Agent, and Scope fields.
|
||
- Keep the worklog and prompt log aligned with the current structured logging framework.
|
||
- Normalize prompt logging into a single consistent `BUILD PROMPT ENTRY` format.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- The AI logging system now uses consistent structured entries across repository instructions, worklog history, and prompt history.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-16 01:34
|
||
Task ID: BUILD-20260316-003
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Introduce the AI agent operational framework and task generation tooling for standardized AI-assisted repository work.
|
||
|
||
Scope:
|
||
- AGENT.md
|
||
- AGENT_WORKFLOW.md
|
||
- AI_TASK_TEMPLATE.md
|
||
- scripts/ai-task
|
||
|
||
Files Modified:
|
||
- AGENT.md
|
||
- AGENT_WORKFLOW.md
|
||
- AI_TASK_TEMPLATE.md
|
||
- scripts/ai-task
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Define separate documents for agent behavior, operational workflow, and reusable task structure.
|
||
- Keep the task generator focused on producing standardized PLAN and BUILD prompts with task IDs and validation requirements.
|
||
- Align the new framework with the repository logging rules and validation workflow.
|
||
|
||
Validation:
|
||
- scripts/ai-task build "test task" src/app/ui.py (passed)
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- The repository now includes a documented AI agent framework and an executable helper tool for generating standardized AI task prompts.
|
||
|
||
Open Issues:
|
||
- None
|