notes

Record structured implementation notes with verification status after task completion.

26|3|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/davidlee/spec-driver --skill notes-davidlee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notes
Source: https://github.com/davidlee/spec-driver/tree/main/.spec-driver/skills/notes
Command: npx skills add https://github.com/davidlee/spec-driver --skill notes-davidlee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of losing critical implementation context after a task or phase ends, which forces future agents to rediscover decisions and pitfalls.

Core Features & Use Cases

  • Actionable completion notes: Records what was done, what was surprising, and what to verify next.
  • Durable memory triggers: Flags reusable patterns/gotchas so knowledge can be maintained for later agents.
  • Repository-aware discovery: Helps you locate the right card/location via the project's tooling when you are unsure.

Quick Start

Use this Skill to record implementation notes immediately after finishing your work by asking the agent to add concise details about what was done, open questions, and any verification status.

Frequently Asked Questions about notes

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

FAQPage Schema
How do I capture implementation notes for future AI agents to maintain context?

To capture implementation notes for future agents, record concise, structured details about completed tasks, including durable facts, surprises, follow-ups, open questions, commit hashes, and verification status.

What should spec-driven development implementation notes include for continuity?

Spec-driven development implementation notes should include durable facts, surprises or adaptations, follow-up actions, open questions, commit references, pending work status, and whether verification succeeded.

When do I need to record verification status and commit references in development notes?

You need to record verification status and commit references when a task or phase completes, ensuring future agents retain critical context for continuity and repairability without rediscovering decisions.

How do I record durable facts and follow-up actions after finishing a development phase?

Record durable facts and follow-up actions after finishing a development phase by asking the agent to add concise, structured details about what was done, open questions, and any verification status.

Can I locate the right project card to store implementation notes if I am unsure where they belong?

Yes, you can locate the right card or location for implementation notes via the project's repository-aware discovery tooling when you are unsure where to store them.

Does this implementation notes approach work without external dependencies?

Yes, capturing implementation notes works without external dependencies, requiring only concise, structured note content to flag reusable patterns and gotchas for later agents.