agentleFS
ulises-jeremiasulises-jeremias/agent-toolkit/skills/delivery/trd/SKILL.md

trd

Skill19 starsChanged 2 months agoMITView on GitHub

WHAT — Draft and review a Technical Requirements Document (TRD) using the template, typically

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Do not dump the full external template into this skill.

    line 34
  2. Distinctive:

    Do not skip risks and testing when the TRD is a handoff artifact.

    line 35

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

TRD — Technical Requirements (WHAT)

Template: references/default-template.md — local reference, kept up to date with the standard structure.

Default guardrails (before any final content)

  1. Apply output-handshake: confirm where the final TRD will live and that a human will review.
  2. Then follow the steps below.

When to use

  • A PRD is approved (or the task is technical-only) and the team needs design-level agreement before build.
  • You need API/data contracts, component boundaries, and test strategy aligned to standards.
  • A client doc hub with PRD/TRD cross-links requires matching document structure.

Instructions

  1. Open the TRD template (references/default-template.md). Align sections: Scope, Architecture overview, Data model / API contracts, Technical decisions (link ADRs and spikes), Dependencies, Risks & constraints, Testing strategy, Implementation plan.
  2. Map from PRD: user stories and AC from the PRD should appear as addressed in the TRD with clear technical response; if no PRD exists, state that explicitly and list assumptions.
  3. For ADRs that block or explain design, use adr to structure the decision, then link the task or ADR in the forge per your engagement.
  4. Delegate repo facts to assistant (conventions, CI, existing patterns); cite sources.
  5. For ticket updates, use the appropriate tool (clickup-cli, jira-*, etc.); keep task comments short with links to the Doc (per workflow-generic-project).

What not to do

  • Do not dump the full external template into this skill; use references/default-template.md as the local canonical reference.
  • Do not skip risks and testing when the TRD is a handoff artifact.

References

  • output-handshake — destination and review
  • references/default-template.md — local TRD template
  • references/example-unified-api.md — TRD example for a full API migration (see PRD link in that file)
  • references/example-api-migration.md — detailed TRD example with phases, architecture, and testing strategy
  • prd — when work starts from product requirements
  • spike — research findings used as design evidence
  • adr — decision records linked from the TRD
  • development-workflow — validation and traceability expectations
  • incident — failure handling / incident implications when relevant
  • workflow-generic-project — delivery gates and traceability
  • clickup-cli, jira-* — ticket / comment operations (per engagement)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.