sprawl add

Artifact Engine

Smart injection engine for rules, skills, atoms, personas, and workflows.


📌 1. The Target Problem

1. The Target Problem

"How do I inject a new rule, skill, or workflow from our company's DNA registry directly into my project's manifest without editing YAML files manually?"

Manually editing YAML manifests leads to formatting errors (tabs instead of spaces, wrong indentation) and requires lookups of the exact artifact name. This slows down development.


⚙️ 2. Usage & Options

sprawl add <item_name>

Options & Flags

  • item_name: The category/name string of the artifact (e.g. 'rules/coding-standards' or 'skills/web-guidance').

🔍 3. How it Works (Under the Hood)

  1. Verifies availability of the target artifact inside the global DNA paths (~/.sprawl/core/ or ~/.sprawl/dna/).
  2. Parses and modifies .agents/sprawl_manifest.yml to append the artifact to the appropriate section.
  3. Triggers a local sprawl sync to compile rules and pull in dependencies automatically.

🩺 4. Troubleshooting

  • Error: Artifact not found in DNA registry
  • Resolution: Run sprawl ls to see available DNA components and check your naming spelling.

🔗 Related Resources & Tutorials