Menu
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/tomevault-io/skills-registry --skill madr-enforcementThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
| Use when this capability is needed.
> Use when this capability is needed.
Review architecture and API design for the vfs-s3 project. Use when the user mentions @architect, asks to review an issue's design, discuss module boundaries, API shape, or architectural decisions for vfs-s3. Also trigger when the user wants to create an ADR (Architecture Decision Record) or evaluate a technical approach for the project. Intended for dispatch from Codex automation or Claude routines; GitHub trigger phrase: @vfs-s3-bot please prepare design doc Use when this capability is needed.
Based on SOC occupation classification
Showing SKILL.md
| name | madr-enforcement |
| description | > Use when this capability is needed. |
This skill ensures that code written in the CellixJS project adheres to the architectural standards, patterns,
and guidelines documented in our Markdown Any Decision Records (MADRs). All ADRs are located in
apps/docs/docs/decisions/ and represent binding architectural decisions that must be followed.
Use this skill when:
All architectural decisions are documented in apps/docs/docs/decisions/. The following ADRs define
standards that MUST be enforced in code:
Standards to Enforce:
Bounded Contexts - Code must be organized by bounded context
packages/ocom/domain/contexts/{context-name}/Entity Structure - Entities must follow DDD patterns
{entity}.tsValue Objects - Immutable objects defined by their values
{entity}.value-objects.ts@lucaspaganini/value-objects frameworkAggregate Roots - Entry points for entity clusters
{entity}.ts (aggregate root entities)Unit of Work Pattern - Atomic operations on domain models
{entity}.uow.tsLayer Separation
Code Review Checklist:
Standards to Enforce:
Package Organization
pnpm-workspace.yaml@ocom/* or @cellix/*Build System
pnpm run buildpnpm run build:affectedTesting
pnpm run test:affectedCode Review Checklist:
Standards to Enforce:
Linting and Formatting
biome.jsonpnpm run lintType Safety
any types without justificationCode Style
pnpm run formatCode Review Checklist:
Standards to Enforce:
Test Framework
pnpm run test:coverageTest Organization
Coverage Requirements
packages/*/coverage/Code Review Checklist:
Standards to Enforce:
Security Scanning
pnpm run snykVulnerability Management
.snyk fileWorkflow
snyk_code_scan MCP toolCode Review Checklist:
gh-advisory-database MCP tool?Standards to Enforce:
Observability
@azure/monitor-opentelemetryIntegration
@ocom/service-otelCode Review Checklist:
Standards to Enforce:
IaC Language
iac/ directoryResource Naming
Deployment
Code Review Checklist:
Standards to Enforce:
Azure Functions
cellix.registerAzureFunctionHandler()Service Registration
Cellix class for DI orchestrationserviceRegistry.registerService()Context Specification
setContext()Code Review Checklist:
Standards to Enforce:
Authentication
Authorization
Code Review Checklist:
Standards to Enforce:
Data Loading
UI Patterns
useLoaderData()Code Review Checklist:
Identify Relevant ADRs
apps/docs/docs/decisions/ for applicable standardsApply ADR Standards
Verify Compliance
pnpm run lintpnpm run testpnpm run snykpnpm run verifyCheck ADR Alignment
Common Violations
Request Changes
Check Existing ADRs
Determine if New ADR Needed
Create ADR if Required
apps/docs/docs/decisions/Correct Implementation:
// packages/ocom/domain/contexts/user/user.ts
export interface UserProps {
readonly id: UserId;
readonly email: Email;
readonly profile: UserProfile;
}
export class User implements AggregateRoot<UserProps> {
constructor(private props: UserProps) {}
get id(): UserId { return this.props.id; }
updateEmail(newEmail: Email): void {
// Domain logic here
this.props = { ...this.props, email: newEmail };
}
// No database or infrastructure code here!
}
Incorrect Implementation (violates ADR-0003):
// ❌ WRONG: Domain entity with database code
export class User {
async save(): Promise<void> {
await mongoose.model('User').save(this); // Infrastructure in domain!
}
}
Correct Implementation:
// Proper dependency injection
Cellix.initializeServices<ApiContextSpec>((serviceRegistry) => {
serviceRegistry.registerService(new ServiceMongoose(...));
serviceRegistry.registerService(new ServiceOtel(...));
})
.setContext((serviceRegistry) => ({
domainDataSource: contextBuilder(serviceRegistry.getService(ServiceMongoose)),
telemetry: serviceRegistry.getService(ServiceOtel)
}));
Correct Commands:
# Build all packages
pnpm run build
# Build only affected packages
pnpm run build:affected
# Test with turbo caching
pnpm run test
Incorrect:
# ❌ WRONG: Building individual packages directly
cd packages/ocom/domain && npm run build
When generating code:
Start with ADR Review
Generate Code Following Standards
Verify Compliance
apps/docs/docs/decisions/apps/docs/docs/decisions/adr-template.mdConverted and distributed by TomeVault — claim your Tome and manage your conversions.