skills.rest
fppfurtado
fppfurtadoCOMMUNITY
Explore all skills by this author →
GitHub

note

Append timestamped notes to a local NOTES.md file.

Updated Apr 30, 2026
Search Tags:#notes#cross-project#timestamp#append-only#local-store#note
One-click install
npx skills add https://github.com/fppfurtado/pragmatic-dev-toolkit --skill note-fppfurtado
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: note
Source: https://github.com/fppfurtado/pragmatic-dev-toolkit/tree/main/skills/note
Command: npx skills add https://github.com/fppfurtado/pragmatic-dev-toolkit --skill note-fppfurtado

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Este skill facilita a captura de contexto ao adicionar notas com carimbo de data/hora no arquivo .claude/local/NOTES.md, mantendo um histórico local e facilmente consultável sem interferir no repositório principal.

Core Features & Use Cases

  • Append-only notes com timestamp para registrar contexto entre sessões.
  • Suporte a uso intra-projeto e escrita cross-project através da opção --to, com inicialização de target conforme ADR-054.
  • Compatibilidade com estratégias de registro de notas e ADRs relacionadas, sem exigir alterações no código-fonte principal.

Quick Start

Adicione uma nota com timestamp ao arquivo .claude/local/NOTES.md do repositório atual.

Frequently Asked Questions about note

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

FAQPage Schema
How do I append timestamped notes to a local notes store?▼

Append timestamped notes to a local store by writing context to the .claude/local/NOTES.md file. The system automatically adds UTC timestamps to each entry, maintaining an append-only history without modifying the main source code repository.

Can I write cross-project notes from a single session?▼

Yes, you can write cross-project notes by using the --to flag to target a different repository. This initializes the target notes file according to ADR-054 specifications, allowing you to capture context across multiple projects from your current working directory.

Do I need external dependencies to maintain local markdown notes?▼

No external dependencies are required to maintain local markdown notes. The system operates independently, writing strictly to the designated local NOTES.md file with strict UTC timestamps, ensuring no interference with the main repository commits.

What is the best way to capture context between sessions without committing to the repository?▼

Capture context between sessions without repository commits by using an append-only local notes file. This approach records timestamped context locally in .claude/local/NOTES.md, keeping a queryable history that avoids modifying the main codebase entirely.

Why are my notes not showing up in the main repository commits?▼

Notes do not appear in repository commits because the system enforces append-only behavior strictly to the local .claude/local/NOTES.md file. It is designed to maintain a local history without interfering with or writing to the main source code.

How does an append-only notes file work for tracking project context?▼

An append-only notes file tracks project context by continuously adding new timestamped entries to the end of the local store. This ensures a chronological, unaltered history of context that is easily consultable across different working sessions.

Related Skills

Explore More Content & Communication Skills→
fubirafubira
1

knowledge-manager

Organize project learnings into categorized knowledge files under ~/.claude/knowledge.

Community
Intermediate
alexwoxalexwox

status-update

Generate stakeholder-friendly project status reports from markdown files.

Community
Intermediate
owebboyowebboy
1

session-wrap-up

Automate end-of-session code review, documentation updates, and task tracking.

Community
Advanced
cryptopaficryptopafi

plan

Generate a timestamped Markdown plan and save it to .hermes/plans/.

Community
Intermediate