8000 GitHub - hmmhmmhm/aligns.md at v0.3.0 · GitHub
[go: up one dir, main page]

Skip to content
hmmhmmhmPublic

About

ALIGNS.md helps you and your AI agents share project goals, priorities, and judgment through a maintained alignment skill.

Topics

Resources

Stars

10 stars

Watchers

1 watching

Forks

Repository files navigation

ALIGN.md on a yellow and cyan background with a connected node diagram

ALIGN.md

License: MIT GitHub stars Format: Markdown Available on skills.sh

Define what good means

ALIGN.md records the goals and trade-offs you want your agent to use. The align skill helps you agree on those criteria and revisit them as the work changes.

Several paths converge on a shared reference point

Keep expectations separate

Keep personal criteria in ALIGN.md and the reusable alignment method in the skill. Connect the agreement through your primary agent instruction file, such as AGENTS.md or CLAUDE.md. Use Git history when available. Updating the skill never rewrites your agreement.

Three distinct connected panels represent execution, instructions, and expectations

Continuous self-alignment

Return to alignment when an important decision misses your intent, repeated corrections reveal a missing criterion, or you are unsure what to do next. You can also review selected PR feedback and accessible project conversations to find recurring criteria, called taste invariants, with their scope and exceptions. Choose recent or full history after seeing the estimated time. Before a long autonomous run, rehearse a few hypothetical choices. Clear errors get fixed directly; settled questions stay settled.

A path gradually corrects its deviations from a steady reference line

Install align

Paste this request into your agent. It sets up the maintained skill and an update policy, then connects it to your project.

Set up the maintained align skill from https://github.com/hmmhmmhm/align.md for this project. Read its current installation guide, check the existing installation and agent instructions, and use the supported installation route for my primary CLI. Ask which CLI I mainly use, and whether it is this one, only if that is unclear.

Enable supported automatic method updates. If the client has no native auto-update option, use a targeted update at the start of each alignment session, preserving the installation scope. Keep a working installed version when offline. Explain which update mode is active; do not add a scheduler or update unrelated packages.

Use the skill to establish or review ALIGN.md and connect the primary instruction file to it. Preserve existing rules and distinct files; propose safe links for any other clients I use. Record the invocation and update policy in ALIGN.md. Reuse clear answers, and suggest a focused alignment check after important judgment mismatches, before untested long autonomous work, or when I am unsure of the next direction. Method updates must never rewrite my personal criteria or count as agreement.

Or install the portable skill directly:

npx skills add hmmhmmhm/align.md --skill align

Then ask: Use the align skill to set up ongoing alignment for this project.

Native plugin installation is available for Codex and Claude Code. Claude Code can update this marketplace automatically when enabled. Other routes can use a user-authorized update at the start of an alignment session. No background updater or universal automatic activation is assumed.

Installation and updates · Behavioral benchmark · Intervention pilot · Preference transfer · Preference retention · Validation · Distribution

License

MIT. Copyright (c) 2026 hmmhmmhm.

ALIGN.md on a green background with overlapping coordinate grids

About

ALIGNS.md helps you and your AI agents share project goals, priorities, and judgment through a maintained alignment skill.

Topics

Resources

Stars

10 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0