# Repository documentation reconciliation

Compare maintained documents with authoritative repository facts, repair stale guidance, and keep historical records distinct from current status. The workflow can update documentation within the requested reconciliation scope.

Package version: 0.1.0-beta.7.

Included with [Faye Coding Assistant](/plugins/faye-coding-assistant/).

## When to use

Use this after development, before release, or whenever repository-wide documentation has drifted.

## What to provide

- The repository and the documentation or release boundary to reconcile.
- Known changes, authoritative commands and inventories, and records that must remain historical.

## Expected results

- Updated current documentation with consistent instructions, counts, and status.
- Repaired local references and a report of unresolved facts or checks the available tools cannot establish.

## Example requests

### Try this request

#### Codex

```
$reconcile-repository-docs Synchronize the release documentation with these local packages. Keep historical test results dated and distinguish local builds from public deployment.
```

#### Grok

```
/reconcile-repository-docs Synchronize the release documentation with these local packages. Keep historical test results dated and distinguish local builds from public deployment.
```

#### Antigravity

```
/reconcile-repository-docs Synchronize the release documentation with these local packages. Keep historical test results dated and distinguish local builds from public deployment.
```

## Requirements

- Read access to source facts and write authorization for the requested documentation reconciliation.
- Node.js is needed only when using the bundled local Markdown reference checker.

## Scope and limitations

- Documentation claims must follow repository evidence; validation or deployment results are not invented.
- The reference checker does not validate every anchor or remote link.
- A bounded edit to one specified document can remain ordinary implementation work.

## Related guides and supporting files

- [Faye Coding Assistant](/plugins/faye-coding-assistant/) — Understand repositories, plan and implement changes, diagnose failures, and review code with clear evidence.
- [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.

## Technical source

[Open original source](/marketplace/plugins/faye-coding-assistant/skills/reconcile-repository-docs/SKILL.md)

Source path: plugins/faye-coding-assistant/skills/reconcile-repository-docs