feature-manifest

Feature Manifest Management

This skill helps you work with the feature manifest system that tracks the relationship between features and their implementations.

When to Use This Skill

• Creating a new feature
• Modifying existing feature code
• Checking which feature owns a file
• Validating manifest accuracy
• Updating changelogs
• Running feature health checks

Quick Commands

# List all features
npm run feature:info -- --list

# Get details about a feature
npm run feature:info -- <feature-id>

# Find which feature owns a file
npm run feature:info -- --files <filepath>

# Validate all manifests
npm run feature:validate

# Check feature health (staleness, orphans, coverage)
npm run feature:health

# Create a new feature manifest
npm run feature:create

Workflow: Creating a New Feature

1. Create the manifest first:

   npm run feature:create -- --id=my-feature --name="My Feature"
   

2. Implement the feature, adding files as you go

3. Update the manifest with:

   • All implementation files in implementation.files
   • Tests in tests.unit/integration/e2e
   • Dependencies in dependencies.internal/external
   • Environment variables in dependencies.env_vars

4. Validate before committing:

   npm run feature:validate
   

Workflow: Modifying an Existing Feature

1. Read the manifest first:

   npm run feature:info -- <feature-id>
   

2. Make your changes to the implementation files

3. Update the manifest:

   • Add new files to implementation.files
   • Update history.last_modified to today's date
   • Add a changelog entry

4. Validate:

   npm run feature:validate
   

Manifest Structure

id: feature-id
name: Human Readable Name
status: complete  # planned | in-progress | complete | deprecated
priority: P1

description: |
  What this feature does and why it exists.

implementation:
  files:
    - src/app/api/feature/route.ts
    - src/lib/feature.ts
  entry_point: src/lib/feature.ts
  database_tables:
    - tableName
  api_routes:
    - POST /api/feature

tests:
  unit:
    - src/lib/__tests__/feature.test.ts
  integration: []
  e2e: []

dependencies:
  internal:
    - features/authentication.yaml
  external:
    - package-name
  env_vars:
    - FEATURE_SECRET
  secrets:
    - feature-api-key

history:
  created: "2024-12-01"
  last_modified: "2024-12-23"

changelog:
  - version: "1.0.0"
    date: "2024-12-23"
    changes:
      - "Initial implementation"

Health Report Interpretation

When running npm run feature:health:

• Healthy Features: Manifest matches code, tests exist
• Stale Features: Manifest not updated in 90+ days, or code changed after manifest
• Without Tests: Complete features that have no tests listed
• Orphaned Files: Files in src/ not tracked by any manifest
• Suggested Manifests: New directories that should have manifests

Best Practices

1. One feature per manifest - Keep them focused
2. Update on every change - Don't let manifests go stale
3. Changelog is append-only - Never modify old entries
4. Include all files - Don't leave orphaned files
5. Link dependencies - Show which features depend on others