Ase Sync Reconcile

@${CLAUDESKILLDIR}/../../meta/ase-control.md @${CLAUDESKILLDIR}/../../meta/ase-skill.md @${CLAUDESKILLDIR}/../../meta/ase-getopt.md

Reconcile Artifact Set to Artifact Set

$ARGUMENTS

Reconcile the target artifact kinds to reflect the current state of the source artifact kinds, by reading the source artifacts and aligning the target artifacts accordingly: .

@${CLAUDESKILLDIR}/../../meta/ase-format-meta.md @${CLAUDESKILLDIR}/../../meta/ase-format-spec.md @${CLAUDESKILLDIR}/../../meta/ase-format-arch.md @${CLAUDESKILLDIR}/../../meta/ase-format-task.md @${CLAUDESKILLDIR}/../../meta/ase-tenets.md

Procedure ---------

1. The recognized artifact kinds are the seven tokens TASK,

SPEC, ARCH, CODE, DOCS, INFR, and OTHR. Parse as the comma-separated kind list and as the comma-separated kind list. Upper-case and trim every parsed kind token. Do not output anything.

1. is empty">

Only output the following and then immediately STOP processing the entire current skill:

⧉ ASE: ☻ skill: ase-sync-reconcile, ▶ ERROR: empty target artifact list

1. is equal 'AUTO'">

Set to the seven recognized kinds TASK,SPEC,ARCH,CODE,DOCS,INFR,OTHR minus all kinds present in . Do not output anything.

1. If any token in or is not one of the seven

recognized kinds, only output the following (with set to the first offending token) and then immediately STOP processing the entire current skill:

⧉ ASE: ☻ skill: ase-sync-reconcile, ▶ ERROR: unknown artifact kind: ****

1. is not 'true'">

Remove from any kind that is also present in (a kind is never its own source).

is empty">

Only output the following and then immediately STOP processing the entire current skill:

⧉ ASE: ☻ skill: ase-sync-reconcile, ▶ ERROR: empty source -- nothing to update from

1. Report the resolved target and source with the following :

TARGET: SOURCE:

1. Do not output anything in this STEP 2.

1. For all kinds in the union of and ,

call the ase_artifact_list(kind: [ ... ]) tool of the ase MCP server once, passing the lower-cased kind tokens, and read the returned artifacts array of { kind, files } objects to obtain the project-relative file list per kind.

1. is not empty">

Honor the filtering to reduce the source and/or target artifacts and/or the aspects of those artifacts you should take into account.

1. Read all (optionally filtered) source and target artifacts

previously resolved and build a precise understanding of the current state they represent.

1. Internalize and honor the artifact-format conventions:

• the artifact-set/artifact/aspect meta information (ase-format-meta.md),
• the SPEC format (ase-format-spec.md),
• the ARCH format (ase-format-arch.md),
• the TASK format (ase-format-task.md).

Whenever a target artifact belongs to one of these kinds, the update MUST keep it conformant to the corresponding format (headings, structure, identifiers, and the ` rule). The kinds CODE, DOCS, INFR, and OTHR` have no dedicated format contract and are treated as free-form.

1. You MUST internalize and strictly honor the GENERIC TENETS,

the RECONCILIATION TENETS, the REFACTORING TENETS, and the CRAFTING TENETS of the ASE Tenets when updating in the following. Do not output anything.

1. Once call the ase_timestamp(format: "yyyy-LL-dd HH:mm") tool of

the ase MCP server to find out the current time and store it in .

1. is equal 'true'">

Bidirectionally update the and artifacts so that they faithfully reflect the current state of each other.

Unidirectionally update the artifact files so that they faithfully reflect the current state of the artifacts.

Keep changes as surgical as possible: change only what the input state actually requires, and do not rewrite unrelated parts of an output artifact.

Apply the update directly to the output artifacts via the Write/Edit tools.

For each formatted output artifact kind, strictly honor its format contract.

Whenever an output artifact is changed and contains a Modified: line, replace this with Modified: .

1. Report the performed updates with the following , listing

one bullet line per changed output file (with its project-relative path and an ultra-brief description of what was reconciled):

UPDATED ARTIFACTS:

• ``:

[...]

Only output the following :

UPDATED ARTIFACTS: none -- all outputs already reflected source state

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: rse
• Source: rse/ase
• License: Apache-2.0
• Homepage: https://ase.tools

Install and usage instructions live in the source repository linked above.