archeology

Scan code surfaces and draft retroactive intent skeletons for missing specifications.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Dektora/dekspec-public --skill archeology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archeology
Source: https://github.com/Dektora/dekspec-public/tree/main/plugins/dekspec/skills/archeology
Command: npx skills add https://github.com/Dektora/dekspec-public --skill archeology

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps in recovering spec gaps in brownfield projects by scanning code surfaces, identifying missing specifications, and drafting retroactive intent skeletons.

Core Features & Use Cases

  • Brownfield Spec Gap Recovery: Starts from orphaned code surfaces and works back to a ratifiable intent.
  • Code Analysis: Scans public APIs and identifies files without locked intents.
  • Intent Drafting: Drafts retroactive intent skeletons for orphaned files.
  • Use Case: When adopting DekSpec in a brownfield repository or backfilling vibecoded work, use this skill to recover missing specifications.

Quick Start

To propose an intent for a specific file, use the command: /dekspec:archeology --propose-intent path/to/file.py

Frequently Asked Questions about archeology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I recover missing specifications in a brownfield codebase?

To recover missing specifications in a brownfield codebase, you can scan code surfaces to identify gaps and draft retroactive intent skeletons that bridge the divide between code and documentation.

What is retroactive intent drafting for orphaned code?

Retroactive intent drafting is the process of analyzing public APIs in orphaned files to propose standardized specifications, working backward from existing code surfaces to a ratifiable intent.

How do I propose an intent for a specific file without existing specifications?

You can propose an intent for a specific file without existing specifications by running the command `/dekspec:archeology --propose-intent path/to/file.py` to generate a drafted intent skeleton.

Can I use this to backfill specifications for vibecoded work?

Yes, you can use this skill to backfill specifications for vibecoded work by scanning the codebase to identify files without locked intents and automatically drafting missing specification skeletons.

When do I need brownfield spec gap recovery?

You need brownfield spec gap recovery when adopting specification frameworks in a repository with no existing specs, helping bridge the gap between undocumented code and formal documentation.

Does this code analysis tool work with repositories that have no documentation?

Yes, this code analysis tool specifically targets repositories with no existing documentation by scanning public APIs to identify files without locked intents and proposing retroactive specifications.