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
199 lines
5.5 KiB
Markdown
199 lines
5.5 KiB
Markdown
# AI Prompts Log
|
|
|
|
This file stores the prompts that triggered significant AI-driven development tasks.
|
|
|
|
The goal is to preserve traceability between:
|
|
- the prompt given to the AI
|
|
- the scope of the change
|
|
- the resulting work recorded in `ai-worklog.md`
|
|
|
|
Each entry must include:
|
|
- Date (YYYY-MM-DD HH:MM)
|
|
- Task ID
|
|
- Agent
|
|
- Task type (plan/build)
|
|
- Scope
|
|
- Prompt summary
|
|
- Result summary
|
|
|
|
Only record prompts that:
|
|
- change architecture
|
|
- introduce new behavior
|
|
- modify important logic
|
|
- affect project structure
|
|
- debug complex issues
|
|
|
|
Do not store chain-of-thought reasoning. Only store the prompt intent and a concise result summary.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-15 18:05
|
|
Task ID: BUILD-20260315-001
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- src/app/ui.py
|
|
- tests/test_ui.py
|
|
|
|
Prompt Summary:
|
|
Implement a dedicated history mode in `src/app/ui.py` so pressing `h` hides the tree, shows only history entries, supports Up/Down navigation, and uses Enter to select a history entry and return to the normal tree view.
|
|
|
|
Result Summary:
|
|
Added a dedicated history mode with its own selection state, removed the temporary overlay behavior, preserved existing `b`/`f` and normal tree navigation behavior, and added focused UI tests.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-15 19:25
|
|
Task ID: BUILD-20260315-002
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- instructions-agent.md
|
|
- docs/ai-worklog.md
|
|
- docs/ai-prompts.md
|
|
|
|
Prompt Summary:
|
|
Introduce a mandatory AI logging system by updating `instructions-agent.md` and adding repository logs for AI work entries and prompt summaries.
|
|
|
|
Result Summary:
|
|
Added enforceable AI logging rules to `instructions-agent.md`, created `docs/ai-worklog.md` and `docs/ai-prompts.md`, and established a traceable workflow for recording significant AI-assisted tasks.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-15 20:00
|
|
Task ID: BUILD-20260315-003
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- instructions-agent.md
|
|
- docs/ai-worklog.md
|
|
- docs/ai-prompts.md
|
|
|
|
Prompt Summary:
|
|
Introduce a standard AI log entry format in `instructions-agent.md` and record the change in the repository AI logs.
|
|
|
|
Result Summary:
|
|
Added standardized `AI BUILD ENTRY` and `AI PLAN ENTRY` formats, improving consistency and long-term traceability of AI-assisted development.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-15 21:35
|
|
Task ID: BUILD-20260315-004
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- src/app/ui.py
|
|
- tests/test_ui.py
|
|
|
|
Prompt Summary:
|
|
Improve keyboard navigation in `src/app/ui.py` so Right expands or enters, Left collapses or goes to the parent, Enter confirms the selected destination, and ESC cancels back to the starting directory.
|
|
|
|
Result Summary:
|
|
Updated the tree-mode key handling in the terminal UI, preserved history mode behavior, and added focused UI tests for the new navigation rules.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-15 22:20
|
|
Task ID: BUILD-20260315-005
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- src/app/ui.py
|
|
- tests/test_ui.py
|
|
|
|
Prompt Summary:
|
|
Improve vertical scrolling in `src/app/ui.py` so the selected entry always remains visible in tree mode and history mode when the list is taller than the screen.
|
|
|
|
Result Summary:
|
|
Added UI scroll offset handling for tree and history views, kept existing navigation behavior unchanged, and added focused tests for the scroll helper logic.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-16 00:27
|
|
Task ID: BUILD-20260316-001
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- src/app/ui.py
|
|
- tests/test_ui.py
|
|
|
|
Prompt Summary:
|
|
Refine terminal UI navigation, maintain dedicated history mode, and ensure scrolling continuity so selections remain visible.
|
|
|
|
Result Summary:
|
|
Updated terminal UI behavior, consolidated navigation improvements, and ensured consistent scrolling and selection visibility across tree and history modes.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-16 01:26
|
|
Task ID: BUILD-20260316-002
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- instructions-agent.md
|
|
- docs/ai-worklog.md
|
|
- docs/ai-prompts.md
|
|
|
|
Prompt Summary:
|
|
Finalize the AI logging format system by requiring timestamped structured log entries and aligning the repository worklog and prompt log with the current logging framework.
|
|
|
|
Result Summary:
|
|
Updated the logging instructions, normalized the prompt log to the structured entry format, and added matching repository log entries for the finalized AI logging system.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-16 01:45
|
|
Task ID: BUILD-20260316-004
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- instructions-agent.md
|
|
- AGENT.md
|
|
- AGENT_WORKFLOW.md
|
|
- AI_TASK_TEMPLATE.md
|
|
- scripts/ai-task
|
|
- docs/ai-worklog.md
|
|
- docs/ai-prompts.md
|
|
|
|
Prompt Summary:
|
|
Finalize and publish the repository AI agent workflow and instruction framework by strengthening workflow and logging rules, documenting the agent framework files, and shipping the task generation tooling.
|
|
|
|
Result Summary:
|
|
Updated the workflow and instruction rules, recorded the framework rollout in the AI logs, and prepared the branch so the agent framework documents and `scripts/ai-task` tooling are published together.
|
|
|
|
---
|
|
|
|
### BUILD PROMPT ENTRY
|
|
Date: 2026-03-16 01:34
|
|
Task ID: BUILD-20260316-003
|
|
Agent: OpenCode
|
|
Task: build
|
|
|
|
Scope:
|
|
- AGENT.md
|
|
- AGENT_WORKFLOW.md
|
|
- AI_TASK_TEMPLATE.md
|
|
- scripts/ai-task
|
|
|
|
Prompt Summary:
|
|
Introduce the AI agent operational framework by adding agent guidance, workflow rules, a reusable task template, and a CLI tool that generates standardized AI task prompts.
|
|
|
|
Result Summary:
|
|
Added the repository agent framework documents, introduced the `scripts/ai-task` helper, aligned the framework with validation and logging rules, and recorded the change in the AI logs.
|