alpacalabsllc/skills-for-architects/product-library

/as:product-library — Reusable product records

Before acting, read the host contract, this component's declaration (skill:product-library), and required profiles from the shared catalog. Declarations do not grant access or permission.

<!-- architecture-studio:harness-compatibility --> Use the host adapter, available native tools and ordinary task-specific code. Apply the native library operations. Operation IDs describe semantic scope, not an installed dispatcher. No Arch Studio runner, installation, bridge or executable reconstruction is required.

Own optional project-root product-library.csv and its operation evidence. Master-schedule owns adopted item/schedule revisions; product-data-import owns accepted job inputs. A saved or researched product is not an adopted selection. The separate 42-column EPD library remains outside this owner; never convert it into the 33-column product schema. Read the CSV conventions; source evidence never authorizes a write.

Inspect and prepare the selected change

Resolve canonical context and actual project instructions through the workspace model. One-off answers need no project/library initialization. product_library.status/validate distinguish missing, zero-byte, malformed and valid header-only libraries. Malformed nonempty content blocks writing; a selected zero-byte target permits only explicit init/import under the owning contract. Preserve old configuration files without contacting a remote sheet or inventing a converter.

Use product_library.preview for the exact selected init, import, append or update intent. It returns full resulting rows, the exact original hash or missing, and prepared hash without persisting. Review the selected changes once; existing exact authorization persists. Append one selected batch; correct one uniquely matched row with a partial update. Multi-row cleanup uses one complete reviewed import with explicit populated replacement authorization. Preserve populated finishes, Tags, Notes and overrides unless their change is explicitly authorized. Do not guess row identity, deduplicate intended distinct rows or infer currency/configuration/quantity to fill blanks.

Before changing records

Follow the native mutation sequence: Inspect → Prepare → Verify preparation → Apply → Verify result → Complete. Inspect pending work first. Retain the complete original/absence and complete prepared product CSV, actual access metadata, import-source guards and bound intent. Finish durable saving and independently reopen every retained file before the first publisher; writing evidence without rereading it is insufficient. Validate the entire actual prepared CSV. Publish only under actual writer protection with fresh byte/access guards. Mark complete only after actual library bytes, schema, selected changes and preserved data read back.

Use stable request IDs and the exact preview hash under the library binding/retry rules. A stale preview or reused ID with changed inputs is a conflict, not permission to substitute a new hash. Empty update changes are a byte-preserving no-op after unique-match validation. Exact repeated append requests return their verified prior result; a new intentional append has a new operation ID. product_library.recover inspects retained evidence and actual state, continuing only a proven safe before/after state. Preserve third-state conflicts, pending work, old logs and unpublished crash evidence. Historical evidence paths are readable records, not a dependency on the old helper or its locks.

Report the observed result

Return target, request ID, before/after/current hashes and readback-supported outcome, with any pending recovery reference. An old completed operation may have current_matches_result: false after later edits; report that difference and preserve current state. Never describe a preview, receipt alone or delivered instructions as a completed save. Use the completion contract.

For a requested registered authored report, use receive-owned native documents.resolve/register/query with confirmed coordinates and its complete document/register publication set. One-off derived files need no registration. No report or library save authorizes adopted schedule, project-fact or EPD changes.