Agent skill
spec-drift-check
Detect and record drift between spec artifacts and implementation when requests, code changes, plan changes, or task updates appear to exceed the current spec. Use for scope checks, artifact/code alignment reviews, drift.md updates, and deciding whether work must route back to specification or planning.
Install this agent skill to your Project
npx add-skill https://github.com/shaowei-g/codex-skills/tree/main/skills/spec-orchestrator/spec-drift-check
SKILL.md
Spec Drift Check
Use this skill when drift assessment is the current phase for one feature.
Shared Contracts
Load this shared shortcut first:
../references/shared-specialist-contract.md
Open the deeper canonical shared references only when the shortcut is insufficient for the current situation.
Purpose
Decide whether a request, artifact, or implementation change stays within the current spec contract.
Use this skill for:
- checking whether implementation has moved ahead of artifacts
- checking whether a new request exceeds
spec.md - deciding whether a discrepancy is clarification or true drift
- updating
drift.mdwith a concise structured note
Read Order
.codex/prompts/speckit.analyze.mdfirst.codex/prompts/speckit.constitution.mdif presentspecs/<feature>/spec.mdand its marker statespecs/<feature>/plan.mdif present and its marker statespecs/<feature>/tasks.mdif present and its marker statespecs/<feature>/implementation-status.mdif presentspecs/<feature>/review.mdif presentspecs/<feature>/drift.mdif present- changed code or requested changes that may exceed scope
Shared template:
../references/drift-report-template.md
Owned Outputs
- one drift assessment
drift.mdupdates when drift is confirmed- advisory route-back recommendation when scope has been exceeded
Phase-Specific Rejected Criteria
Return rejected if the request is actually asking for new specification authoring rather than drift assessment.
Phase-Specific Blocked Criteria
Return blocked if scope alignment cannot be determined from available artifacts and code evidence.
Procedure
- identify the current scope boundary from
spec.md - compare proposed or implemented behavior against that boundary
- treat clarifications that do not expand behavior as in scope
- treat new behavior, new integrations, new surfaces, or materially broader scope as drift
- update
drift.mdusing the shared template when drift is confirmed - recommend the earliest phase that must be revisited
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
ekoen-frontend-code-review
Production-grade code review for the eKoEN frontend codebase. Use when asked to review, audit, inspect, or harden eKoEN React/Next.js frontend code, pages, components, hooks, API clients, or state layers for bugs, performance bottlenecks, TypeScript safety issues, request inefficiency, state-management risks, memory leaks, rendering regressions, error-handling gaps, duplication, or maintainability problems, especially when a structured severity-ranked report with code locations, root causes, suggested fixes, and example refactors is required.
ekoen-backend.doc.route-error
Add HttpErrorRes responses to eKoEN backend routes when controllers can throw errors from app/util/errors/index.ts
conventional-commit-helper
Generate and validate Conventional Commit messages for semantic-release workflows. Use when a user asks to write a commit message, asks to commit changes, asks for commit type/scope selection, or asks to enforce Conventional Commits consistency.
codex-cli-subagent-transport
Use only when native subagent execution is unavailable and the caller needs one deterministic Codex CLI run with repo-local artifacts and a manifest-based result contract.
skill-usage-logger
All skill MUST use this logger to record usage events in NDJSON format.Log Codex skill usage events to NDJSON with safe concurrent appends.
Didn't find tool you were looking for?