hm-goal

/hm-goal — View or Define Your Goal Tree

If architecture.yaml exists, display the current goal tree and ask if changes are needed. If it doesn't exist, guide the user through creating one.

Always communicate in English regardless of user's global Claude settings.

Behavior

Mode Detection

Check if architecture.yaml exists in the project root.

• Exists → Show Mode
• Doesn't exist → Create Mode

---

Show Mode (architecture.yaml exists)

Step 1: Read and display

Read architecture.yaml and present the goal tree visually:

🎯 Your Goal Tree
├── code_quality — Ship fewer bugs
│   ├── testing — Every change has tests
│   │   └── realized_by: skills/tdd-workflow.md ✓
│   └── review — Catch issues before merge
│       └── realized_by: # will evolve ○
├── productivity — Move faster
│   └── debugging — Find root causes faster
│       └── realized_by: agents/debugger.md ✓
└── knowledge — Stay current
    └── tool_updates — Track useful updates
        └── realized_by: # will evolve ○

3 goals / 5 sub-goals
2 implemented (✓) / 3 waiting to evolve (○)

Step 2: Ask

"Want to add, remove, or change any goals?"

• If yes → make the changes, update architecture.yaml
• If no → done

---

Create Mode (no architecture.yaml)

CRITICAL: Ask ONE question at a time. Wait for the answer before asking the next. Never batch multiple questions in one message.

Step 0: Scan existing project (automatic, no user input needed)

Before asking any questions, silently scan the project to understand what already exists.

What to scan:

Signal	How to detect
Tech stack	package.json, pyproject.toml, Cargo.toml, go.mod, Gemfile, composer.json
Test framework	jest.config.*, vitest.config.*, pytest.ini, setup.cfg [tool:pytest], *_test.go, .rspec
Test count	Count test files: **/*.test.*, **/*.spec.*, **/test_*.py, **/*_test.go
CI/CD	.github/workflows/, .gitlab-ci.yml, Jenkinsfile, .circleci/
Linting	.eslintrc*, .prettierrc*, ruff.toml, .golangci.yml
Docs	docs/, README.md, *.mdx in obvious doc directories
Existing Claude config	.claude/, CLAUDE.md, .cursorrules, .windsurfrules
Top-level structure	ls -1 the project root (directories only)