Achra Guidelines

Overview

Achra platform guidelines for architecture, conventions, business domains, and technical patterns. This skill covers where code lives, how to name and structure it, when to use feature flags, and how domains and routes map.

WIP: These guidelines are a draft. When a task is not covered here or in linked references, prefer consistency with existing Achra code and patterns.

When to Apply

Reference these guidelines when:

• Writing new code in the Achra codebase (components, pages, services, hooks, providers, etc)
• Writing or reviewing Storybook stories
• Creating skeleton loaders, loading placeholders, Suspense fallbacks, or Next.js loading.tsx
• Refactoring or reviewing code for Achra consistency
• Adding a new module, feature, or route
• Answering questions about Achra architecture, business domains, or conventions
• Deciding where to place a component or whether to add a feature flag
• Answering questions about Achra's tech stack or choosing libraries/tools