spec-lock

Bi-directional code and documentation synchronizer. Use when editing code that affects specifications, API contracts, or documentation. Prevents documentation rot by maintaining sync between implementation and docs. Automatically detects drift and suggests updates.

Aller à l'installation

Dépôt: aegntic/cldcde
Dernière activité de la source: 13 février 2026 à 10:14
Langue détectée de SKILL.md: anglais
Étoiles: 11
Forks: 3

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/aegntic/cldcde --skill spec-lock

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

council

Run a 5-adviser council to stress-test any decision. Five distinct lenses (Contrarian, First-Principles, Expansionist, Outsider, Executor) answer independently, then anonymously peer-review each other, and a Chairman synthesizes a single clear recommendation. Kills sycophancy and groupthink on high-stakes calls.

2026-06-27

ae-proof-agent

Diligence-grade product and technical analysis for the ae.ltd proof-agent concept, including comparison against Cursor and Omnara, MVP and production architecture, red-team review, and build-vs-buy evaluation. Use when Codex needs to create or critique PRDs, tech specs, competitive diligence, leadership memos, or multi-agent evaluation packs for agent-runtime, demo-agent, or proof-agent products.

2026-03-13

ae-ltd-claude-template-switchboard

Use when creating or upgrading CLAUDE.md instructions and selecting the right template baseline for repo size, architecture, and team constraints. AE.LTD template decision workflow.

2026-03-11

Tout voir dans ce dépôt

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit(*)|Write(*)",
        "command": "python3 /a0/usr/plugins/spec-lock/spec-lock.py --check"
      }
    ]
  }
}

# Check a file for drift
python3 /a0/usr/plugins/spec-lock/spec-lock.py --check <file>

# Register a new dependency
python3 /a0/usr/plugins/spec-lock/spec-lock.py --register <code> <spec> [priority]

# Show sync status
python3 /a0/usr/plugins/spec-lock/spec-lock.py --status

# Force full sync
python3 /a0/usr/plugins/spec-lock/spec-lock.py --sync

files:
  "src/auth/**":
    spec_source: "AUTH_SPEC.md"
    priority: code  # Code wins (security)
  
  "docs/api/**":
    spec_source: "API_SPEC.md"
    priority: spec  # Spec wins (contracts)
  
  "src/models/**":
    spec_source: "DATA_MODEL.md"
    priority: ask   # Always ask user

// Code has:
function createUser(name, email, role)

// Spec says:
function createUser(name, email)
// DRIFT: 'role' parameter not documented

// Code changed from:
POST /api/v1/users

// To:
POST /api/v2/users
// DRIFT: Version change not in API_SPEC.md

// Code changed:
const timeout = 5000;  // Was: 30000

// Spec still says:
"Request timeout: 30 seconds"
// DRIFT: Config value changed

CREATE TABLE spec_dependencies (
    code_file TEXT,
    spec_file TEXT,
    last_sync TIMESTAMP,
    drift_detected BOOLEAN,
    priority TEXT
);

# Developer changes JWT expiry
vim src/auth/login.ts
# const expiry = '1h';  # Changed from '24h'

⚠️  DRIFT DETECTED in src/auth/login.ts

AUTH_SPEC.md says:
  "Session tokens expire after 24 hours"

Code implements:
  "Session tokens expire after 1 hour"

Priority: CODE WINS (security)
Auto-updating AUTH_SPEC.md...
✅ Documentation synchronized

📊 SYNC STATUS:
  Total Dependencies: 47
  In Sync: 47
  Drifted: 0
  Last Sync: 2026-02-12 13:00:00

1. Debt-Sentinel: Check for anti-patterns
2. Edit allowed to proceed
3. Spec-Lock: Check for doc drift
4. Auto-sync if possible

Level 4: Documentation Sync
  └─ Update all affected specs
  └─ Generate migration guides
  └─ Verify sync status

rm /a0/usr/plugins/spec-lock/spec_dependencies.db

# Register manually
python3 /a0/usr/plugins/spec-lock/spec-lock.py --register src/api/users.js API_SPEC.md spec

files:
  "src/internal/**":
    priority: code  # Internal tools don't need strict spec sync

name	spec-lock
description	Bi-directional code and documentation synchronizer. Use when editing code that affects specifications, API contracts, or documentation. Prevents documentation rot by maintaining sync between implementation and docs. Automatically detects drift and suggests updates.
version	1.0.0
author	Essential 2026 Suite
tags	["documentation","sync","specs","maintenance","drift"]
trigger_patterns	["update documentation","check spec sync","documentation drift","sync specs","spec lock","update spec","check docs","documentation out of date","maintain documentation"]
allowed_tools	["Bash","Read","Write","Edit"]

name	spec-lock
description	Bi-directional code and documentation synchronizer. Use when editing code that affects specifications, API contracts, or documentation. Prevents documentation rot by maintaining sync between implementation and docs. Automatically detects drift and suggests updates.
version	1.0.0
author	Essential 2026 Suite
tags	["documentation","sync","specs","maintenance","drift"]
trigger_patterns	["update documentation","check spec sync","documentation drift","sync specs","spec lock","update spec","check docs","documentation out of date","maintain documentation"]
allowed_tools	["Bash","Read","Write","Edit"]

spec-lock

Options d'installation

Vérifiez les fichiers source

Spec-Lock: Documentation Synchronization

Overview

Spec-Lock: Documentation Synchronization

Overview

The Problem It Solves

How It Works

1. Post-Edit Analysis (PostToolUse Hook)

2. Conflict Detection

3. Auto-Update

When to Use

Usage

Automatic Mode

Manual Commands

Configuration

Priority Rules

Drift Detection

Function Signature Mismatch

API Endpoint Changes

Configuration Changes

Knowledge Graph

Sample Workflow

Developer Edits Authentication

Spec-Lock Detects Drift

Sync Status Updated

Integration

With Debt-Sentinel

With Compound Engineering

Success Metrics

Troubleshooting

Database Locked

Missing Dependencies

False Positives

spec-lock

Informations de source

Options d'installation

Vérifiez les fichiers source

Plus depuis ce dépôt

Spec-Lock: Documentation Synchronization

Overview

Plus depuis ce dépôt

Spec-Lock: Documentation Synchronization

Overview

The Problem It Solves

How It Works

1. Post-Edit Analysis (PostToolUse Hook)

2. Conflict Detection

3. Auto-Update

When to Use

Usage

Automatic Mode

Manual Commands

Configuration

Priority Rules

Drift Detection

Function Signature Mismatch

API Endpoint Changes

Configuration Changes

Knowledge Graph

Sample Workflow

Developer Edits Authentication

Spec-Lock Detects Drift

Sync Status Updated

Integration

With Debt-Sentinel

With Compound Engineering

Success Metrics

Troubleshooting

Database Locked

Missing Dependencies

False Positives