docs/tools/HOWTO-GENERATE-WALKTHROUGH.md
Standard: DSOM For My AI Protocol v6.1 | Cognitive Automation Tools:generate-walkthrough.ps1,generate-walkthrough.shPlatforms: Windows Native (T1), Linux/WSL2 (T2)
1. Purpose
generate-walkthrough is the Session Summarizer of the DSOM ecosystem. It automates the extraction of “Accomplishments” from your Git history and your task.md file, formatting them into a standardised “Session Anchor” block ready to be pasted into walkthrough.md.
Use it to:
- Automatically harvest all commit messages from “Today”.
- Identify all tasks marked as
(SELESAI)in yourtask.md. - Ensure consistent formatting for your daily mental anchors.
- Reduce the manual overhead of the End-of-Day consolidation ritual.
tools/generate-walkthrough.ps1(Windows)tools/generate-walkthrough.sh(Linux/WSL2)
2. Prerequisites
3. Usage
3.1 Standard Generation
4. Operation Workflow (Harvesting Logic)
- Git Harvest: Scans
git logsincetoday. It automatically filters out internalchore(hibernation)commits to keep the output high-density. - Task Harvest: Greps for lines containing
[x]and the tag(SELESAI)(Malay for Complete) to identify finished work. - Block Generation: Prints a Markdown snippet to the console.
5. Reading the Output
The tool prints a block like this:.agents/brain/walkthrough.md file during your End-of-Day ritual. Fill in the [UPDATE ME] fields manually to provide the AI with logical context for the next session.
6. Related Documents
Standard: DSOM For My AI Protocol v6.1 | Harisfazillah Jamel | LinuxMalaysia Document Version: v1.0 | Created: 2026-04-08
Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-07-04 Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0