Concepts

AlignTrue’s core concepts explained. Start with the glossary to understand terminology, then explore how sync works, backup strategies, and team collaboration features.

New here? Read the Glossary, then How sync works before diving into the other concepts.

Quick overview

Use this section to skim and jump directly to what you need.

• Glossary - Defines core terms like scopes, exporters, bundles, and locks—start here.
• How sync works - Walks through the source-of-truth flow from rules to agent exports so you know what runs.
• Backup - Shows what to back up (rules, lockfiles) and where to store them for safety.
• Preventing duplicate rules - Avoids repeating instructions across multiple exporters to keep agent context lean.
• Team mode (team) - Explains collaborative flows, lockfiles, and approval patterns before turning team mode on.
• Drift detection (team; after team mode) - Detects when local rules diverge from approved versions and how to respond.
• Git workflows (team; after team mode) - Covers git sources, vendoring, and sharing strategies once collaboration is enabled.

Learning path

Solo developers start here:

1. Read Glossary - learn key terms.
2. Review How sync works - understand the core flow.
3. Learn about Backup - protect your work.
4. Explore Preventing duplicate rules - optimize agent context.

Teams add these after enabling team mode:

5. Understand Team mode - enable collaboration.
6. Monitor with Drift detection - track alignment and remediate.
7. Share with Git workflows - manage rule sources and vendoring.

See also

• Getting started - Quickstart and setup
• Guides - How-to guides for solo and team workflows
• Customization - Scopes, overlays, and plugs
• Reference - CLI commands, configuration, and agent support