ceratops code consistency audit
- Repo stars 0
- Author repo AI-Agent-Skills
- Domain
- Security
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @Ceratops-Code · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Ceratops Code Consistency Audit
## Goal
Audit repository coherence after combined changes. Across teams this work is
usually split across post-merge validation, integration and regression testing,
release-readiness review, documentation-drift checks, and architectural fitness
functions. Use this skill to run the cross-cutting consistency pass those labels
only partially cover.
## Context
### Inputs To Capture
- Repo or subtree under audit and whether the task is audit-only or
audit-and-fix.
- Recent refactors, branches, PRs, or agent-thread outputs most likely to have
interacted.
- Expected sources of truth such as README files, docs, examples, configs,
tests, manifests, generated metadata, automation, or control files.
- Local comment standards such as
`skills/ceratops-gh-repo-lifecycle/references/code-comment-nondeterministic-contract.md`,
README guidance, or language-specific conventions already present in the repo.
- High-risk surfaces such as public APIs, migrations, feature flags, rename
waves, packaging, install flows, or generated artifacts.
Infer missing inputs from repo state before asking.
## Constraints
### Skill-Specific Rules
- Treat repository coherence as the goal. Do not turn the task into a generic
style or code-quality review.
- Start from declared behavior and sources of truth before judging
implementation details.
- Treat conflicts between two declared sources of truth as findings even when
the code still happens to work.
- Prefer concrete contradictions, stale follow-through, and merged-only
interaction bugs over speculative architecture advice.
- Treat comment sufficiency as a non-deterministic maintainability consistency
issue when scripts, public APIs, automation helpers, contract checkers, or
non-obvious safety logic are in scope.
- Use local project conventions and
`skills/ceratops-gh-repo-lifecycle/references/code-comment-nondeterministic-contract.md`
when present; do not research current language comment standards unless the
user explicitly asks for a standards refresh.
- When git history or recent merge context is available, judge the current
merged result against the latest target-branch state, not each branch in
isolation.
- Do not ask for credentials for normal local repo audits.
- If external systems are genuinely needed, first exhaust local repo state,
local git history, and no-auth metadata.
### Boundaries
- Use this skill when a repo may have semantic drift after merges, refactors,
migrations, or parallel agent work and the user wants a consistency audit
rather than style feedback.
- If the user wants only a code review for bugs or regressions inside a bounded
patch, use normal review flow instead of this whole-repo audit.
- If the task is only diagnosing and fixing one current breakage, stop and use
`$ceratops-task-lifecycle` with the `execute-in-stages` action.
- If the task is only documentation maintenance without broader repository
coherence concerns, narrow the work to documentation drift rather than running
the full audit.
### Workflow
#### 1. Define intended behavior first
- Identify declared behavior from the highest-signal local sources: README
files, docs, examples, tests, configs, manifests, automation, control files,
naming, and contracts.
- For skill repos or agent repos, treat `SKILL.md`, `agents/openai.yaml`, README
tables, bundled resources, and any install metadata as first-class sources of
truth.
- If multiple artifacts disagree about the intended behavior, record that
conflict explicitly instead of guessing which one is correct.
#### 2. Map merged interaction surfaces
- Inspect adjacent modules, flags, configs, scripts, templates, tests, and
examples that were likely touched by separate refactors or threads.
- Use git history, diff context, or merge context when available to find where
independently reasonable changes now interact.
- Prioritize hidden coupling, duplicated logic that drifted, partial renames,
stale options, orphaned files, and follow-through gaps.
#### 3. Run consistency passes
Check as many of these as the repo justifies:
- implementation vs README and docs
- implementation vs examples, scripts, and run instructions
- file names and stated purpose vs actual behavior
- tests vs current intended behavior
- configs, manifests, automation, and control files vs implementation
- public interfaces vs internal assumptions
- comments vs non-obvious behavior, safety boundaries, external side effects,
script usage, and README-maintained workflow expectations
- merged-only edge cases that appear when features or refactors combine
- stale artifacts, dead references, partial migrations, and unused compatibility
shims
- documented validation commands only for touched surfaces: Markdown or docs,
YAML or workflows, Python helpers or validators, and skill source or
governance files. Treat lint or type output as consistency evidence, not as
generic style findings.
#### 4. Validate findings before reporting
- Prefer findings that point to exact conflicting artifacts, exact
inconsistency, actual risk, and the smallest credible fix.
- Avoid style nits, naming preferences, or refactor suggestions unless they are
needed to resolve a real contradiction.
- Distinguish confirmed findings from plausible but unverified risk areas.
#### 5. Fix only when asked or clearly justified
- Default to audit and report.
- If the user asked to repair the repo or the smallest safe fix is already in
scope, apply the narrowest credible correction and rerun the relevant checks.
- Escalate before risky deletions, broad rewrites, or behavior-changing
interpretation choices.
#### 6. Close with explicit coverage
- Classify important checked surfaces as consistent, conflicting, blocked, or
not verified.
- If no findings remain, say so explicitly and note the residual coverage limits
instead of implying exhaustive certainty.
## Done When
### Completion Gate
- Verify the audit inspected the repo's declared sources of truth, not only the
implementation files.
- Verify merged interaction surfaces and likely cross-thread integration seams
were checked where evidence existed.
- Verify comments and README coverage are sufficient for important scripts,
public interfaces, automation helpers, and non-obvious safety or contract
logic when those surfaces were part of the audit.
- Verify every reported finding ties back to concrete conflicting artifacts or
an explicitly stated verification gap.
- Verify the final answer reports findings, important consistent areas, and
important verification limits without drifting into generic review commentary.
- Verify relevant documented validation commands were run or explicitly scoped
out for touched Markdown, YAML, Python, and skill-source surfaces.
### Output Contract
Report only:
- findings ordered by severity
- for each finding: conflicting artifacts, exact inconsistency, risk, and the
smallest credible fix
- important areas checked and found consistent
- anything important not verified
If no findings remain, say so explicitly and mention the main residual risk
areas or coverage limits.
### Example Invocation
`Use $ceratops-code-consistency-audit on this repo. Ignore style. Find
post-merge contradictions, docs-to-code drift, stale assumptions, and
merged-only edge cases.`
Sections and files
Listed in source order.
sections -> Goal → Context → Inputs To Capture → Constraints → Skill-Specific Rules → Boundaries
terms -> Audit repository coherence after combined changes. · - Repo or subtree under audit and whether the task is audit-only or audit-and-fix. · Infer missing inputs from repo state before asking. · - Treat repository coherence as the goal. · - Prefer findings that point to exact conflicting artifacts, exact inconsistency, actual risk, and the smallest credible fix. · - Default to audit and report. · - Classify important checked surfaces as consistent, conflicting, blocked, or not verified. · - Verify the audit inspected the repo's declared sources of truth, not only the implementation files.
files/cmd -> skills/ceratops-gh-repo-lifecycle/references/code-comment-nondeterministic-contract.md · $ceratops-task-lifecycle · execute-in-stages · agents/openai.yaml
body sha256 -> e09d8256a823
Goal
Audit repository coherence after combined changes. Across teams this work is usually split across post-merge validation, integration and regression testing, release-readiness review, documentation-drift checks, and architectural fitness functions. Use this skill to run the cross-cutting consistency pass those labels only partially cover.
Inputs To Capture
Repo or subtree under audit and whether the task is audit-only or audit-and-fix. Recent refactors, branches, PRs, or agent-thread outputs most likely to have interacted. Expected sources of truth such as README files, docs, examples, configs,
Skill-Specific Rules
Treat repository coherence as the goal. Do not turn the task into a generic style or code-quality review. Start from declared behavior and sources of truth before judging implementation details. Treat conflicts between two declared sources of truth as findings even when
Boundaries
Use this skill when a repo may have semantic drift after merges, refactors, migrations, or parallel agent work and the user wants a consistency audit rather than style feedback. If the user wants only a code review for bugs or regressions inside a bounded patch, use normal review flow instead of this whole-repo audit.
Workflow
SKILL.md,agents/openai.yaml, README