feature-code-sync

Reconcile a foundation:SoftwareFeature with the codebase and create UserStories for missing capabilities.

19|3|Updated Jul 19, 2024
One-click install
npx skills add https://github.com/danielterra/FOUNDATION --skill feature-code-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-code-sync
Source: https://github.com/danielterra/FOUNDATION/tree/main/.claude/skills/feature-code-sync
Command: npx skills add https://github.com/danielterra/FOUNDATION --skill feature-code-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill reconciles a foundation:SoftwareFeature with the current codebase, identifying deltas between the ontology (graph) and the implemented code, and surfaces inconsistencies for remediation.

Core Features & Use Cases

  • Identify implemented capabilities that exist in code but are missing from the graph.
  • Create UserStories for these capabilities and tag drifted stories as "Mudança Pendente" when code diverges from the original acceptance criteria.
  • Flag UserStories that have no corresponding code to keep the backlog visible for review.

Quick Start

Provide a Feature IRI such as foundation:SoftwareFeature_1777574442863 to begin the reconciliation pass.

Frequently Asked Questions about feature-code-sync

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

FAQPage Schema
How do I reconcile software features with the current codebase?

To reconcile software features with the current codebase, provide a SoftwareFeature IRI to identify deltas between the ontology graph and implemented code. It surfaces missing capabilities and updates changelogs for remediation.

What is codebase and ontology graph synchronization for user stories?

Codebase and ontology graph synchronization compares implemented code against a SoftwareFeature graph to manage user stories. It tags drifted stories as Mudança Pendente and creates new ones for untracked capabilities with clear acceptance criteria.

How do I flag drifted user stories when code diverges from acceptance criteria?

To flag drifted user stories when code diverges from acceptance criteria, run a reconciliation pass against the SoftwareFeature. The sync automatically marks divergent stories as Mudança Pendente and records metadata updates in the changelog.

Can I create user stories for capabilities implemented in code but missing from the graph?

Yes, you can create user stories for capabilities implemented in code but missing from the graph. The reconciliation process identifies these orphaned capabilities and generates new user stories with clear acceptance criteria and changelog entries.

Does the feature code sync execute code or trigger user story planning?

The feature code sync does not execute code or trigger user story planning and implementation. It strictly performs metadata updates using add_property_values to write deltas to feature and user story changelogs safely.