CONTRIBUTING.md

Contributing

This repository turns durable engineering ideas into reusable agentic artifacts.

What Makes A Good Case

A good case starts from source material that still contains useful engineering judgment after its original tooling context has aged.

Good sources include:

• Technical talks
• Conference videos
• Blog posts
• Essays
• Book chapters
• Design documents
• Historical engineering notes

Avoid sources whose value depends only on outdated tool instructions.

Case Study Requirements

Each case should include:

• README.md: short overview and artifact index
• source-notes.md: source identity and context, without full copyrighted transcript
• principle-extraction.md: durable ideas extracted from the source
• modern-mapping.md: what changed in the modern agentic context
• adaptation-layers.md: possible outputs and the selected output layers
• reflection.md: what the adaptation preserved and changed
• artifacts/: generated skills, prompts, checklists, workflows, rubrics, or drills

Use templates/case-study-template.md when adding a new case.

Copyright And Attribution

• Link to source material when possible.
• Do not commit full transcripts, full articles, or long excerpts unless you have permission.
• Use brief quotes only when necessary.
• Prefer paraphrase, principle extraction, and original adaptation.
• Clearly separate source facts from your interpretation.

Artifact Quality Bar

Artifacts should be:

• Reusable beyond the original source
• Concrete enough to run inside a workflow
• Grounded in engineering tradeoffs
• Clear about when to use and when not to use them
• Small enough to maintain

Naming

Use stable, readable names:

cases/001-short-source-theme/
artifacts/skills/specific-skill-name/
artifacts/prompts/specific-prompt-name.md
artifacts/checklists/specific-checklist-name.md
artifacts/workflows/specific-workflow-name.md

Number cases in chronological repo order, not source publication order.