plan-on-md
A skill to save plans to local Markdown after creating them in plan mode
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
TODO
- Store a plan in the Obsidian vault that has been made in advance
Path
The path is composed of the following parts.
- ~/uuta/Projects/{project_name}/{branch_name}/{file_name}.md
{project_name}
The project name is the name of directory that an agent work on. For example, if you work on the following path,
- ~/triceps
the project name become the following one.
- triceps
The important point is the suffix numeric number should be removed from the directory name.
- ~/triceps22
The above path becomes the following one.
- triceps
The reason is we occasionally clone GitHub projects with the gitwork tree. Avoiding duplicated directory names, we tend to add suffix number. Precisely, we can say a project name with a suffix number differs from the project without a suffix number, but those projects can be considered the same one.
{branch_name}
Basically, the branch name should be regexed with the following pattern due to multiple reasons.
- xxx/#123 -> 123
- xxx and / should be removed from the branch name since xxx is tedious and / means a directory.
-
#should be removed since when NeoVim tries to find a file, it doesn't work
The next examples are practical.
- hotfix/#123 -> 123
- feature/#123 -> 123
{file_name}
The file name should be the summarized name based on a plan an agent created.
- handler-implementation-plan.md
- xx-method-refactor-plan.md
Use-case
.e.g,
- path: ~/curry2
- branch_name: feature/#468
- ~/uuta/Projects/curry/468/middleware-refactor-plan.md
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!