How does it handle truth cases?

The skill reads updated code and relevant truth-case JSONs to highlight key assumptions, invariants, and reference example truth-case IDs in the docs.

What files does Phoenix Docs Sync update?

It specifically targets calculations.md, project READMEs, JSDoc within server analytics files, and phase validation reports.

Can it handle complex financial logic?

Yes, it is specifically designed for complex modules including XIRR, waterfalls, fee structures, and capital allocation logic.

Does it modify code behavior?

No, its primary purpose is to ensure that documentation and JSDoc accurately reflect the existing code behavior and implementation.

Why use this skill instead of manual documentation?

It prevents documentation rot by ensuring every semantic change in calculations is reflected in the documentation within the same change set, maintaining a high standard of technical accuracy.

Phoenix Docs Sync

Name: Phoenix Docs Sync
Author: nikhillinit

bynikhillinit

0•

Learning & Documentation

Synchronizes technical documentation and JSDoc with actual code behavior to ensure accuracy in complex calculation modules.

Phoenix Docs Sync is a specialized skill designed to bridge the gap between implementation and documentation within complex financial and analytical codebases. It automatically updates JSDoc, markdown guides, and phase reports whenever changes are made to core modules such as XIRR, waterfalls, or fee structures. By analyzing updated code and truth-case JSON files, the skill ensures that your technical documentation remains a reliable source of truth, effectively preventing 'documentation rot' and ensuring that plain-English descriptions match current mathematical logic.

Key Features

01Updates markdown documentation for complex financial calculations like XIRR and waterfalls

02Clarifies truth-case semantics and invariant logic in plain English

03Synchronizes JSDoc parameters and returns with implementation logic

04Ensures consistency between code behavior and phase validation reports

05Validates documentation reflects current precision and Decimal.js handling

060 GitHub stars

Use Cases

01Updating technical documentation after modifying capital allocation or exit recycling logic

02Syncing technical specifications with recent changes in analytics modules

03Clarifying clawback behavior in JSDoc after a logic refactor

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nikhillinit/updog_restore phoenix-docs-sync

For use in Claude.ai and ChatGPT

Download Skill