phycool-doc-sync

Maps code changes to required documentation updates and enforces doc freshness rules.

10|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill phycool-doc-sync-cynthia1070711
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phycool-doc-sync
Source: https://github.com/Cynthia1070711/PHYCOOL_Tools/tree/main/config-templates/claude/skills/phycool-doc-sync
Command: npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill phycool-doc-sync-cynthia1070711

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code changes frequently leave project documentation stale: new EF migrations ship without schema doc updates, new services never appear in architecture docs, and completed epics go unrecorded. This Skill defines a standard that maps each code change type to the exact documents that must be updated, with freshness thresholds and audit tracking. ## Core Features & Use Cases - Code-to-Doc Impact Mapping: A priority-ranked table (P0/P1/P2) linking changes like EF migrations, SignalR hubs, middleware, and RBAC rules to specific docs such as database-schema.md and architecture/platform-services.md. - Freshness Enforcement: A 2-week (14-day) staleness threshold, last-updated source recording format, and last_synced_epic tracking scanned during Epic Closing Audits (TD-28). - Doc Index Infrastructure: Integrates with Context Memory DB tables (doc_index, document_chunks, document_embeddings) and scheduled scripts like scan-doc-index.js for automatic re-indexing. - Use Case: After adding a new EF Core migration, consult the mapping table to confirm database-schema.md is a P0 update, apply the change, and record the last-updated tag with version, date, and source story. ## Quick Start Ask the assistant to check which documents need updating after your latest code changes using the phycool-doc-sync mapping table.

Frequently Asked Questions about phycool-doc-sync

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

FAQPage Schema
How do I keep architecture documentation in sync with code changes?

Use a code-to-doc impact mapping table that assigns each change type (migration, service, hub, middleware) a priority and target document. Update the mapped doc, then record a last-updated tag with version, date, and source story ID.

What documents should I update after adding an EF Core migration?

A new EF Core migration or entity is a P0 change requiring an update to database-schema.md, including the entity definition table and ER diagram if present. Record the migration name and story ID as the update source.

How do I detect outdated documentation in a project?

Compare the most recent migration date against each doc's last-updated date; anything older than 14 days is flagged as outdated. You can grep for "Last updated" markers across the docs directory and sort by date.

What is last_synced_epic tracking used for?

Each Skill's frontmatter records last_synced_epic and last_synced_date so an Epic Closing Audit can scan for Skills that fell behind the current epic. Outdated entries are flagged and updated via the sync workflow.

When should I not use this doc sync standard?

Do not use it for Skill content rewrites, tech debt tracking, or code quality review; those belong to dedicated workflows like skill sync mode, debt registry, and review analyst. It only governs documentation synchronization.