---
project: mantle
author: 110059232+chonalchendo@users.noreply.github.com
date: '2026-03-30T22:03:42.122316'
commands_used:
- research
- simplify
tags:
- type/session-log
---

## Summary
Researched Claude Code best practices, identified 6 user-facing improvements, implemented all 6, simplified, and released v0.7.10.

## What Was Done
- Cloned shanraisshan/claude-code-best-practice repo, analyzed 104 files
- Identified 6 improvements that benefit end users (not just developer experience)
- Implemented: skill folder structure with progressive disclosure, trigger descriptions, agent maxTurns/effort, memory prompting in commands, context:fork on heavy commands, enhanced install defaults
- Simplified skills.py (deduplicated branches)
- Released v0.7.10

## Decisions Made
- Always use references/core.md subfolder (not flat reference.md) for progressive disclosure
- Transform descriptions at compile time (vault keeps original, compiled gets trigger format)
- context:fork for research and challenge commands (isolated execution)

## What's Next
- Test skill progressive disclosure with a real project
- Monitor whether trigger descriptions improve auto-invocation

## Open Questions
- None