76 lines
2.3 KiB
Markdown
76 lines
2.3 KiB
Markdown
# 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
|