# Coding Assistant

Understand repositories, plan and implement changes, diagnose failures, and review code with clear evidence.

Package version: 0.1.0-beta.7.

## Overview

Fourteen focused skills cover the repository lifecycle, from understanding existing behavior to implementation, maintenance, and handoff. Each workflow keeps its evidence, scope, and change authority explicit.

## What you can do

- Trace behavior and turn a concrete objective into an actionable plan.
- Implement requested changes or diagnose failures with focused verification.
- Review code, reconcile documentation, and prepare useful continuation notes.

## Get started

- [Codebase exploration](/skills/faye-coding-assistant/codebase-exploration/) — Understand repository structure or trace existing behavior.
- [Repository change planning](/skills/faye-coding-assistant/repository-change-planning/) — Plan a bounded change before implementation.
- [Repository implementation](/skills/faye-coding-assistant/repository-implementation/) — Carry out an authorized repository edit.
- [Repository debugging](/skills/faye-coding-assistant/repository-debugging/) — Diagnose a concrete failure; apply fixes only when requested.

## Requirements

- Provide the repository, a bounded question or change, and relevant constraints.

- Most skills can work in the parent if optional bundled agents are unavailable.

- Script-backed analysis needs Node.js.

- Planning and review establish evidence before separately authorized implementation; existing permission is preserved.

## Skills and supporting files

- [Code review](/skills/faye-coding-assistant/code-review/) — Review a diff or named code surface for actionable defects and material risks.
- [Codebase exploration](/skills/faye-coding-assistant/codebase-exploration/) — Understand where behavior lives and how data, configuration, and ownership connect across a repository.
- [Coding goal guardrails](/skills/faye-coding-assistant/coding-goal-guardrails/) — Keep a multi-step coding goal bounded, observable, and careful with existing Git work.
- [Coding goal progress report](/skills/faye-coding-assistant/report-coding-goal-progress/) — Turn an authoritative coding-goal snapshot into a clear status, milestone, or completion report.
- [Coding handoff](/skills/faye-coding-assistant/coding-handoff/) — Prepare durable continuation notes or reviewer-facing context from known work and evidence.
- [Phase implementation review](/skills/faye-coding-assistant/phase-implementation-review/) — Assess a completed phase or cumulative phased result against its accepted scope and completion criteria.
- [Repository documentation reconciliation](/skills/faye-coding-assistant/reconcile-repository-docs/) — Bring repository documentation into agreement with current code, commands, structure, and release state.
- [Refactor planning](/skills/faye-coding-assistant/refactor-planning/) — Plan a structural change or compatibility migration while preserving the behavior consumers depend on.
- [Repository change planning](/skills/faye-coding-assistant/repository-change-planning/) — Build a bounded implementation plan from the repository's current behavior and the intended outcome.
- [Repository debugging](/skills/faye-coding-assistant/repository-debugging/) — Find the cause of a concrete failure or unexpected behavior, then make a repair when requested.
- [Repository implementation](/skills/faye-coding-assistant/repository-implementation/) — Implement a bounded repository change and verify the behavior it affects.
- [Source file token estimation](/skills/faye-coding-assistant/source-file-token-estimation/) — Estimate the source footprint of large files and compare hypothetical splits before deciding whether restructuring is worthwhile.
- [Test suite health](/skills/faye-coding-assistant/test-suite-health/) — Assess the cost, stability, overlap, and maintainability of an existing test suite.
- [Verification planning](/skills/faye-coding-assistant/verification-planning/) — Choose focused checks that demonstrate the changed behavior and expose meaningful regression risks.
- [Read-only coding analyst](/agents/faye-coding-assistant/faye-coding-analyst/) — Defines a bounded analysis role for exploration, diagnosis, review, planning, suite assessment, and handoff.
- [Implementation assistant](/agents/faye-coding-assistant/faye-coding-assistant/) — Defines a write-capable role for explicitly authorized, bounded implementation or repair.
- [Independent goal reviewer](/agents/faye-coding-assistant/faye-goal-fresh-review/) — Defines a read-only reviewer for material risks or conflicting completion evidence in a coding goal.
- [Goal report editor](/agents/faye-coding-assistant/faye-goal-reporter/) — Defines a read-only editor for richer authoritative coding-goal snapshots.
- [Source footprint analyst](/agents/faye-coding-assistant/source-file-token-estimator/) — Defines a read-only role for explicit file inventories and approximate token-footprint scenarios.
- [Git-visible file discovery](/scripts/faye-coding-assistant/git-file-discovery-af2ef3b7/) — Collects repository-visible paths and distinguishes supported fallback conditions from Git failures.
- [Repository path utilities](/scripts/faye-coding-assistant/repository-paths-4af93ae5/) — Normalizes and compares repository paths used by discovery and validation tools.
- [Managed workspace storage](/scripts/faye-coding-assistant/workspace-storage-09d1ad7c/) — Enforces project-local destinations for supported report-writing operations.
- [Markdown reference checker](/scripts/faye-coding-assistant/check-document-references-d074367c/) — Audits supported local Markdown references without editing repository files.
- [Document discovery](/scripts/faye-coding-assistant/document-discovery-b3033991/) — Finds Markdown and MDX files within the requested repository boundary.
- [Markdown reference parsing](/scripts/faye-coding-assistant/markdown-references-0f0779e1/) — Extracts the local reference forms supported by the documentation checker.
- [Local reference validation](/scripts/faye-coding-assistant/reference-validation-f77e4198/) — Resolves extracted document references and classifies missing or unsafe local targets.
- [Shared file analysis](/scripts/faye-coding-assistant/common-workspace-analysis-cc37385f/) — Computes file categories, line counts, aggregates, and hypothetical split costs.
- [File analysis options](/scripts/faye-coding-assistant/analysis-options-64a2f205/) — Parses and validates shared size thresholds and chunk-size options.
- [Source file discovery](/scripts/faye-coding-assistant/workspace-discovery-5b1d0b26/) — Selects candidate source-like files for the inventory and token estimation workflows.
- [Source footprint report command](/scripts/faye-coding-assistant/source-file-token-estimate-752cfe6e/) — Produces approximate token totals and hypothetical line-chunk comparisons for large source-like files.
- [Workspace file inventory command](/scripts/faye-coding-assistant/workspace-file-inventory-ac1f6451/) — Lists the large source-like files and metadata used by token-footprint analysis.
- [Shared code review contract](/references/faye-coding-assistant/review-contract-877c9410/) — Defines evidence, finding quality, verification gaps, and the boundary between review and remediation.
- [Coding workspace storage](/references/faye-coding-assistant/workspace-storage-e67b2ca0/) — Defines contained project-local storage for reports, ledgers, and temporary coding evidence.
- [Goal workflow boundaries](/references/faye-coding-assistant/anti-overlap-8af3974e/) — Separates goal guardrails from focused coding, utility, and GitHub workflows.
- [Goal Git policy](/references/faye-coding-assistant/git-handling-policy-ac867766/) — Explains how goal work preserves existing changes and applies explicit Git authorization.
- [Goal ledger template](/references/faye-coding-assistant/goal-ledger-template-9c7283e1/) — Provides a compact record of a coding goal's state, evidence, decisions, and continuation context.
- [Goal completion handoff](/references/faye-coding-assistant/handoff-template-1d3cf775/) — Structures the accepted outcome, validation, Git state, risks, and next action at goal handoff.
- [Bounded coding delegation](/references/faye-coding-assistant/subagent-routing-b82c29b0/) — Guides the use of focused read-only and write-authorized roles within a coding goal.
- [Goal reporter input](/references/faye-coding-assistant/reporter-handoff-979a28cc/) — Defines the authoritative facts supplied to the optional goal report editor.

## Package manifest

[View package manifest](/manifests/faye-coding-assistant/)
