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.

Stars 0
Forks 0

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.md with a concise structured note

Read Order

  • .codex/prompts/speckit.analyze.md first
  • .codex/prompts/speckit.constitution.md if present
  • specs/<feature>/spec.md and its marker state
  • specs/<feature>/plan.md if present and its marker state
  • specs/<feature>/tasks.md if present and its marker state
  • specs/<feature>/implementation-status.md if present
  • specs/<feature>/review.md if present
  • specs/<feature>/drift.md if present
  • changed code or requested changes that may exceed scope

Shared template:

  • ../references/drift-report-template.md

Owned Outputs

  • one drift assessment
  • drift.md updates 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

  1. identify the current scope boundary from spec.md
  2. compare proposed or implemented behavior against that boundary
  3. treat clarifications that do not expand behavior as in scope
  4. treat new behavior, new integrations, new surfaces, or materially broader scope as drift
  5. update drift.md using the shared template when drift is confirmed
  6. recommend the earliest phase that must be revisited

Expand your agent's capabilities with these related and highly-rated skills.

shaowei-g/codex-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.

0 0
Explore
shaowei-g/codex-skills

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.

0 0
Explore
shaowei-g/codex-skills

ekoen-backend.doc.route-error

Add HttpErrorRes responses to eKoEN backend routes when controllers can throw errors from app/util/errors/index.ts

0 0
Explore
shaowei-g/codex-skills

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.

0 0
Explore
shaowei-g/codex-skills

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.

0 0
Explore
shaowei-g/codex-skills

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.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results