Skip to content

Kropiunig/Alignr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

     ___    __    _____ _______ _   _ ______
    /   |  / /   /  _/ / ___/ // | / / __  /
   / /| | / /    / /  / / _/ /|  / / /_/ /
  / ___ |/ /____/ /  / /_/ / / |/ / _, _/
 /_/  |_/_____/___/  \____/_/  |_/_/ |_|

Align yourself. Be the agent of your own life.


Most systems tell you what to do. This one asks you who you are.

Alignr is a framework for aligning your days with your deepest values. Not productivity theater. Not goal-chasing. The slow, deliberate work of becoming the person your ambitions require.

It is also, quietly, an AI-native system. The CLAUDE.md at the root gives an AI agent the instructions to read your values, observe your patterns, and reflect back what you might not see. You remain the author. The agent is the margin note.

The Cycle

graph LR
    V[Values] --> G[Goals]
    G --> P[Daily Plan]
    P --> A[Action]
    A --> R[Reflection]
    R --> W[Weekly Review]
    W --> M[Monthly Review]
    M --> Y[Yearly Review]
    Y --> V
    R --> P
    style V fill:#1a1a2e,stroke:#e94560,color:#eee
    style G fill:#1a1a2e,stroke:#e94560,color:#eee
    style P fill:#16213e,stroke:#0f3460,color:#eee
    style A fill:#16213e,stroke:#0f3460,color:#eee
    style R fill:#16213e,stroke:#0f3460,color:#eee
    style W fill:#0f3460,stroke:#533483,color:#eee
    style M fill:#0f3460,stroke:#533483,color:#eee
    style Y fill:#0f3460,stroke:#533483,color:#eee
Loading

Structure

.
├── CLAUDE.md                  ← agent instructions (the mirror)
├── .claude/
│   └── commands/
│       ├── today.md           ← /today — open the day
│       ├── reflect.md         ← /reflect — close the day
│       ├── check.md           ← /check — mid-day alignment check
│       ├── weekly.md          ← /weekly — weekly review
│       └── monthly.md         ← /monthly — monthly review
├── alignment/
│   ├── VALUES.md              ← the ground truth
│   ├── GOALS.md               ← waypoints, not destinations
│   ├── METRICS.yml            ← mirrors, not scorecards
│   ├── PRINCIPLES.md          ← operating rules
│   ├── QUESTIONS.md           ← open tensions to hold
│   ├── PHILOSOPHY.md          ← the deeper why
│   ├── TARGETS.md             ← organizations and outreach
│   ├── CASE_STUDIES.md        ← proof of work
│   ├── 30-60-90_PLAN.md       ← role onboarding template
│   ├── TOOL_CONCEPT.md        ← product ideation scaffold
│   ├── LOG.md                 ← change log
│   ├── daily/                 ← the practice
│   └── reviews/
│       ├── weekly/            ← surface patterns
│       ├── monthly/           ← recalibrate
│       └── yearly/            ← hold the arc

Getting Started

  1. Fork this repo. It is yours now.
  2. Open VALUES.md. Write what actually matters to you. Weight it honestly.
  3. Set GOALS.md — goals that express those values, not goals that ignore them.
  4. Create your first daily note. Plan three things. Do them. Reflect.
  5. At the end of the week, sit with the weekly review.
  6. Let the agent help — or don't. The system works either way. The agent just makes the mirror sharper.

Philosophy

Read the full Philosophy. The short version:

  • Alignment over optimization. An optimized life can be perfectly productive and perfectly hollow.
  • The daily practice is the method. Grand visions are cheap. Almost nobody has a practice for today.
  • Goals are useful fictions. Hold them lightly. Revise them when they stop serving your values.
  • The only failure is to stop looking. A day with zero output but clear seeing is not a failed day.

Using with Claude Code

Alignr ships with native Claude Code support. If you use Claude Code, five slash commands are ready out of the box:

Command What it does
/today Opens your day — creates today's note, reads your values, helps set your Top 3
/reflect Closes your day — fills the log, writes a reflection, generates tomorrow's suggestions
/check Mid-day alignment check — are you working on what you said matters?
/weekly Runs a weekly review across all daily notes
/monthly Zooms out — are the goals still the right goals?

Setup (30 seconds):

# 1. Fork this repo, then clone your fork
git clone https://github.com/YOUR-USERNAME/Alignr.git
cd Alignr

# 2. Open Claude Code in the repo root
claude

# 3. Fill in your values first — everything else follows from here
# Open alignment/VALUES.md and write what actually matters to you

Once Claude Code is open in the repo, the slash commands load automatically. Start with /today.

No configuration file. No API key. No subscription. Claude Code reads the repo, the commands run the protocol.

The system works without the agent. The agent just makes the mirror sharper.

The Agent

The CLAUDE.md file contains instructions for an AI agent (Claude, or any LLM that reads repo context) to operate within this system. The agent:

  • Reads your values, goals, and recent notes
  • Helps you plan aligned days and close them with honest reflection
  • Surfaces patterns in weekly, monthly, and yearly reviews
  • Names misalignment directly — not to judge, but to illuminate

The agent does not motivate. It does not optimize. It mirrors.

License

MIT — built for one, offered to all.

About

A plain-text alignment system for people who want their days to mean something. Powered by Claude.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors