Files
gh-nathanvale-side-quest-ma…/commands/_shared/create-workflow.md
2025-11-30 08:42:13 +08:00

2.3 KiB

Shared Create Workflow

Reference file for /para:create-* commands.

File Naming Convention (REQUIRED)

See: naming-convention.md in this folder.

Standard: Title Case with Spaces → Folder/Title Case with Spaces.md

User Input Filename
"tassie holiday 2025" Tassie Holiday 2025.md
"react best practices" React Best Practices.md
"learn piano" Learn Piano.md

Always convert user input to Title Case before creating files.

PARA Principle: Don't Over-Organize

Per Tiago Forte's PARA method:

  • "Keep it to 4-6 items per level maximum"
  • "Resources don't need perfect organization. They just need to be findable."

Rule: Let structure emerge naturally. Don't create folders preemptively.

Subfolder Logic by Type

Type Subfolder Behavior
Project Always create in 01_Projects/ root
Area Always create in 02_Areas/ root
Resource Suggest existing subfolders if they match title

Resource Subfolder Matching

Only for Resources - if user has existing subfolders:

  1. List subfolders in 03_Resources/ using mcp__MCP_DOCKER__obsidian_list_files_in_dir
  2. If subfolders exist, check if title contextually matches any
  3. If match → Ask user with AskUserQuestion:
    • Matching subfolder(s)
    • Root folder option
  4. If no match or no subfolders → Create in root silently

Never offer "create new folder" - structure should emerge from repeated use.

Matching Examples

Title Existing Subfolders Action
"React Best Practices" Technical/, Work/ Ask: Technical/ or root?
"Docker Tutorial" Technical/, Work/ Ask: Technical/ or root?
"Fishing Trip Guide" Technical/, Work/ Create in root (no match)
"TypeScript Patterns" (none) Create in root

Argument Parsing

Use positional arguments: $1 (title), $2, $3 for optional fields.

  • If arg provided → use it
  • If arg missing → ask with AskUserQuestion

Output Format

✅ Created: [[Title]]
📁 Location: [folder]/[filename].md
📋 Type: [project|area|resource]

MCP Tools

  • mcp__MCP_DOCKER__obsidian_list_files_in_dir - Check subfolders (Resources only)
  • mcp__MCP_DOCKER__obsidian_append_content - Create note