docs

Record project history and decision rationale in structured documentation.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/projectmiluju/factlog --skill docs-projectmiluju
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/projectmiluju/factlog/tree/main/.agents/skills/docs
Command: npx skills add https://github.com/projectmiluju/factlog --skill docs-projectmiluju

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill acts as the dedicated historian for a project, ensuring every decision, context, and outcome is captured in a traceable, non-ambiguous format. It prevents loss of knowledge by requiring structured documentation rather than ad-hoc notes.

Core Features & Use Cases

  • Dev Logs: Create consistent development logs that record context, decisions, and outcomes.
  • ADR & Decision Records: Maintain technical decisions with rationale and alternative considerations.
  • STATUS & README Updates: Keep the project status, changes, and rationale up-to-date for audits and onboarding.

Quick Start

Create a Dev Log entry under docs/devlog with today's date and a descriptive title to begin recording history.

Frequently Asked Questions about docs

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

FAQPage Schema
How do I maintain architecture decision records to capture project rationale?

Architecture decision records capture technical choices, rationale, and alternative considerations to maintain traceability. You record context, decisions, and trade-offs in structured ADRs to ensure accountability and prevent knowledge loss across the project lifecycle.

What is the best way to structure development logs for traceability?

Development logs provide traceability by recording context, decisions, and outcomes in a consistent format. Using standardized templates under a dedicated devlog directory ensures project history is captured non-ambiguously rather than through ad-hoc notes.

How do I document project history and prevent knowledge loss during development?

Documenting project history involves applying consistent templates across dev logs, ADRs, README updates, and STATUS.md files. This structured approach captures why choices were made, alternatives considered, and lessons learned to enforce accountability.

Do I need mandatory frontmatter in SKILL.md to enforce consistent documentation?

Mandatory frontmatter in SKILL.md enforces consistent documentation by requiring structured metadata. This ensures every decision, context, and outcome is captured in a traceable format, preventing the loss of knowledge from unstructured or ad-hoc notes.

Can I use structured templates for project status updates and audits?

Structured templates support project status updates by keeping STATUS.md and README files current with changes and rationale. This ensures the project status remains up-to-date for audits and onboarding by consistently documenting context and decisions.

Why does ad-hoc documentation fail to capture decision rationale effectively?

Ad-hoc documentation fails to capture decision rationale because it lacks structured templates and mandatory frontmatter. Without enforcing consistent formats for context, decisions, and trade-offs, project history becomes ambiguous and knowledge is easily lost.