cd-browser/docs/ai-prompts.md

AI Prompts Log

This file stores relevant prompts used during AI-assisted development.

Only store prompts that:

• change architecture
• introduce new behavior
• modify important logic
• affect project structure
• debug complex issues

Do not store internal chain-of-thought reasoning. Store only the user prompt and a short result summary.

2026-03-15

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

2026-03-15

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

2026-03-15

• 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 a standardized AI BUILD ENTRY and AI PLAN ENTRY format, improved consistency expectations for AI logs, and updated the log files to reflect the new format.

2026-03-15

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

2026-03-15

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

2026-03-16 00:27

• prompt summary: Improve terminal UI navigation by refining tree and history keyboard behavior, adding scrolling continuity so selection stays visible, and preserving confirmation, cancellation, and history mode behavior.
• result summary: Updated src/app/ui.py and tests/test_ui.py to support dedicated history selection, improved Right/Left/Enter/ESC behavior, and vertical scrolling for both tree and history views while keeping the AI logs current.