Files
cd-browser/docs/ai-prompts.md
Saky d9d412973b 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
2026-03-16 03:00:39 +01:00

6.1 KiB

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


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 02:51 Task ID: BUILD-20260316-005 Agent: OpenCode Task: build

Scope:

  • instructions-agent.md
  • AGENT_WORKFLOW.md
  • AI_TASK_TEMPLATE.md
  • scripts/ai-task
  • docs/ai-worklog.md
  • docs/ai-prompts.md
  • docs/ai-execution-log.md

Prompt Summary: Finalize the AI logging framework by aligning instructions, workflow rules, task templates, generator tooling, and all three repository logs, then validate and publish the changes.

Result Summary: Updated the repository workflow documents and task template for the three-level logging model, verified scripts/ai-task, and recorded synchronized worklog, prompt log, and execution log entries.