realign-goals

# realign-goals

Generate a structured goals.md file from interview-style answers about your development philosophy and project direction.

## Usage

```bash
echo "Your answers to philosophy questions..." | realign-goals --project my-project
```

### Arguments

| Flag | Default | Description |
|------|---------|-------------|
| `--project` | `global` | Project name for the frontmatter |

## Input

Free-form text answering questions about your development philosophy:

- What's your vision for this project?
- What principles guide your work?
- What does "done" mean to you?
- What are you actively working on?
- What will you explicitly NOT do?

## Output

A complete `goals.md` file with:

```markdown
---
type: goals
project: my-project
updated: 2024-01-15
sidebar_position: 1
---

# Development Philosophy & Goals

## Vision
[Generated from your answers]

## Principles
- **Principle** - explanation

## Definition of Done
- [Criteria based on your answers]

## Definition of Polished
- [Quality criteria]

---

## Active
- [ ] Current goal #high
- [ ] Another goal #medium

## Future
- [ ] Planned feature #medium

## Non-Goals
- [ ] Thing we won't do - reason
```

## Format Details

- **Checkboxes**: `[ ]` unchecked, `[x]` complete, `[~]` in progress
- **Priority tags**: `#high`, `#medium`, `#low`
- **Sections**: Active (current work), Future (planned), Non-Goals (explicitly avoided)

## Example

```bash
cat << 'EOF' | realign-goals --project development-hub
I want to build tools that make development easier. I believe in simple,
composable tools that do one thing well. Done means it works reliably and
has good docs. I'm currently working on the dashboard and goal tracking.
I won't build a web version - this is a desktop app only.
EOF
```

## Provider

Default: `opencode-claude` - change to your preferred provider in the Tool Builder UI.