Skip to content

🛠️ Dev Log 037 – Criteria + Plan CLI Upgrades

May 26, 2025

Today was a CLI consistency day — small commands, big polish. We focused on aligning dokugent criteria and dokugent plan commands, introducing new flags, and enhancing trace behaviors.

🧱 Plan Improvements

  • ✅ plan trace output restructured for clarity and consistency
  • 📄 plan.index.md used more cleanly across commands
  • ✂️ Removed duplication in trace formatting
  • 🧪 Re-tested --ls, --edit, --show, --check, and --trace

📋 Criteria Command Overhaul

✨ New Features

  • --trace / trace: prints sectioned view of criteria.md
  • Includes token count + validation summary
  • Output now matches plan trace style
  • --t: writes a blank criteria.md scaffold with section headings only
  • Wizard-free
  • Skips write if file exists

🧼 Cleanups

  • Removed duplicate trace case
  • Unified trace output to consistent style
  • --check and --trace now share validation logic
  • --edit launches system $EDITOR
  • --show prints only file contents
  • Rewrote site/docs/commands/dokugent-criteria.md
  • Removed emojis from docs to match plan/agent
  • Added MkDocs frontmatter: title, description, keywords

🧪 Commands Touched

dokugent plan trace
dokugent plan --ls
dokugent plan --edit <stepId>

dokugent criteria
dokugent criteria --t
dokugent criteria --check
dokugent criteria --show
dokugent criteria --edit
dokugent criteria --trace
dokugent criteria trace

⏱️ Total Time

Started: May 25, 7:00PM Ended: May 26, 11:00AM ~16 hour full-stack CLI polish marathon

🧠 Reflections

This was a cleanup day disguised as a feature day. It showed how small flags (--trace, --t) can represent real UX wins when paired with validation, formatting, and output structure that respects the developer.

The criteria.ts file now matches the architecture of plan.ts — and the docs finally reflect what’s really going on under the hood.

Categories