brownfield-ingest

Classify legacy markdown documents into DekSpec artifacts with `dekspec ingest`.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of ingesting and classifying legacy markdown documents into structured DekSpec artifacts, simplifying the onboarding of brownfield repositories.

Core Features & Use Cases

  • Automated Ingestion: Run dekspec ingest on markdown documents to classify them into draft artifacts.
  • Confidence-Scored Classification: Review a classification report with confidence scores to triage artifacts for promotion.
  • Use Case: Onboard a brownfield repository with legacy documentation. Use this Skill to automatically classify the documents into their respective DekSpec artifact slots, streamlining the migration process.

Quick Start

Use the brownfield-ingest skill to classify the legacy document 'docs/legacy/repository-document.md'.

Frequently Asked Questions about brownfield-ingest

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

FAQPage Schema
How do I classify legacy markdown documents during a repository migration?

Classify legacy markdown documents during a repository migration by running the `dekspec ingest` command to automatically parse and map them into structured DekSpec artifacts.

What is brownfield ingest for legacy documentation?

Brownfield ingest is the automated process of onboarding existing repositories by parsing legacy markdown documentation and classifying it into structured draft artifacts.

How do I triage classified documents after an automated ingest?

Triage classified documents after an automated ingest by reviewing the generated classification report, which assigns confidence scores to each draft artifact for promotion decisions.

Can I use this for onboarding brownfield repositories with unstructured markdown?

Yes, you can use this for onboarding brownfield repositories with unstructured markdown by applying automated document classification to generate structured DekSpec artifacts.

What's the best way to convert markdown files into structured DekSpec artifacts?

The best way to convert markdown files into structured DekSpec artifacts is using the `dekspec ingest` command to automate parsing and generate a confidence-scored classification report.