🛠️ Dev Log 038 – Major Changes¶
- Added
dokugent conventionscommand with full interactive and flag-based scaffolding - Enabled
--tflag for instant folder + README generation - Symlink logic now respects agent ID and timestamp versioning
--check,--show, and--traceall follow recursive file validation and token counting patterns- Behavior matches internal CLI consistency for
init,criteria,plan, andagent
🧩 Refined Convention Handling¶
- Built-in protection to skip overwriting known preset types (
writing,research) unless explicitly allowed - Folder layout standard enforced:
.dokugent/data/conventions/<type>/<agentId>@<timestamp>/
.dokugent/data/conventions/<type>/latest → symlink
- Conditional symlink resolution added for nested folders and custom types
🔄 Unified Flag Design¶
Flags now follow shared conventions with other commands:
| Flag | Behavior |
|---|---|
--t | Create README.md with agent ID versioning |
--check | Validate structure + show token totals |
--show | Print contents + token count (alias of trace) |
--trace | Recursively print .md files with tokens |
--edit | Reserved |
🔍 Refactors + Cleanup¶
resolveActivePathnow supports deeper folder resolution for conventions- Removed broken symlink logic from legacy utils
- Patched deploy script to reflect simplified title/header edits
- Created separate
deploy-json.shfor isolated agent content testing
⏭️ Next Steps¶
- Finish
conventionsdoc page - Begin sweeping other commands to ensure MkDocs parity