aimship 0.1.0-preview.4 → 0.1.0-preview.7

package/skills/aimship/references/sources-and-changes.md

@@ -26,3 +26,9 @@ Markdown/HTML are principal carriers, not a format whitelist. Images, screenshot
 4. Review affected work and execute affected verification as required by the goal, then close the same change with its result and remaining issues.
 
 Formatting/typo corrections do not require semantic re-review. Implementation bugs are fixed against the requirements; do not weaken the requirements to match the bug. Tools detect structural problems, not every semantic dependency. State uncertainty in the impact analysis rather than claiming complete automatic coverage.
+
+## Location and version discipline
+
+Preserve raw adopted versions under source/, including source/request.md. Author current requirements in prd.md or adopt authoritative material through scope.md. Formal outputs remain at the delivery root. New source versions are additional records, never replacements of adopted originals. Normal business evidence belongs in .aimship/evidence/; installation diagnostics and repeated state returns belong in product-maintainer validation, not the delivery.
+
+Use CHG for significant changes, stable REQ/AC and exact TC versions. Retain failed RUN and historical REV records. Q closes only after its decision also reaches the affected formal text. See document-patterns for namespaces, retired IDs, split/merge mapping and structure. An explicit full export must identify its date and object/version and remain a snapshot.

package/skills/aimship/references/stages/contract.md

@@ -17,3 +17,7 @@ The cooperating parties have an unambiguous applicable contract consistent with
 A breaking interface/compatibility decision needs its proper authority. Missing consumers or schemas remain stated gaps, not fabricated agreements.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use openapi.yaml or the registered authoritative contract. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/diagnose.md

@@ -17,3 +17,9 @@ The investigation goal is met, or the inability to determine a cause and a concr
 If the apparent small fix expands into behavior or scope changes, explain the impact before dependent implementation.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use diagnosis.md. Preserve the `conclusion` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+
+Only a commissioned independent investigation produces diagnosis.md. Known-cause bugs and normal development debugging stay within their current stage. Record an arrangement change before adding a mid-delivery investigation.

package/skills/aimship/references/stages/frame.md

@@ -17,3 +17,7 @@ The commissioned exploration has a clear objective and its uncertainty is visibl
 A missing business objective or incompatible expected outcomes needs a user decision; independent evidence gathering may continue.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use the selected PRD/Scope requirement entry. Preserve the `goals` section anchor (Scope uses adoption/goals as applicable). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/handoff.md

@@ -17,3 +17,7 @@ The report honestly matches the current commissioned endpoint. Complete the deli
 Showing results does not revise the endpoint. Required blocked verification means incomplete acceptance, even when code is ready. Small later corrections reopen with preserved closure; independent goals create related deliveries.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use handoff.md. Preserve the `outcomes` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/implement.md

@@ -17,3 +17,9 @@ The planned batch is implemented and known deviations are resolved or explicitly
 Expanded external behavior, data handling or authorization needs return to the relevant decision. A rejected permission remains blocked and is not retried through another host.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use plan.md. Preserve the `execution` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+
+Update TASK/B status and actual execution in the existing plan.md, preserving planned versus actual and code versions. Do not generate implementation.md.

package/skills/aimship/references/stages/plan.md

@@ -10,10 +10,14 @@ Define executable batches, each goal and requirement coverage, dependencies, aut
 
 ## Continue when
 
-Batches can be executed in order and together cover the delivery goal. Small work may keep a concise ordered arrangement in state rather than a separate plan.
+Batches can be executed in order and together cover the delivery goal. Every implementation, including a single small batch, requires a completed plan and plan.md before it begins.
 
 ## Decisions and blockers
 
 A material change in scope/endpoint needs a decision; routine task splitting does not. Record the reason if changing the existing order.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use plan.md. Preserve the `tasks` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/prototype.md

@@ -17,3 +17,7 @@ The relevant interactions and states are clear and consistent with current requi
 Missing visual/browser tools require an explicit unverified scope. Resolve contradictory behavior through requirements/Scope; do not silently alter external prototypes.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use the registered prototype entry (new HTML: prototype/index.html). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/requirements.md

@@ -17,3 +17,7 @@ The requirements are adequate for the commissioned next work and material ambigu
 Ask for business behavior, compatibility or endpoint choices that cannot be inferred. Do not invent user acceptance.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use the selected PRD/Scope requirement entry. Preserve the `requirements` section anchor (Scope uses adoption/goals as applicable). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/review.md

@@ -17,3 +17,7 @@ The agreed scope has actually been examined and issues blocking progression are
 Do not replace an agreed human review with agent review. Review cannot be reported as a running test; unrelated work need not be re-reviewed.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use review.md. Preserve the `reviews` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/scope.md

@@ -17,3 +17,7 @@ The goal, authority and scope are clear enough for the selected next work, with
 Material conflicting sources or uncertain authority needs clarification; format differences alone do not. Never choose source priority by filename or date.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use the selected PRD/Scope requirement entry. Preserve the `scope` section anchor (Scope uses adoption/goals as applicable). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/tech-design.md

@@ -17,3 +17,9 @@ The design can guide the agreed next work and correctness-affecting issues have
 Missing schema/dialect or material compatibility/data decisions block dependent design claims. An explicitly revised conceptual-design endpoint must retain these limitations.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use tech-design.md. Preserve the `coverage` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+
+Produce database.sql for one target, or database-<id>.sql per independent target, before completing this stage. No SQL for no database change.

package/skills/aimship/references/stages/test-design.md

@@ -10,10 +10,14 @@ Map each goal/risk to observable checks: normal behavior, relevant errors/bounda
 
 ## Continue when
 
-The goal and material risks have appropriate checks and missing execution conditions are explicit. Simple checklists may share a later report.
+The goal and material risks have appropriate checks and missing execution conditions are explicit. Write cases and coverage in testing.md; execution remains explicitly not run until verify.
 
 ## Decisions and blockers
 
 Missing tools or execution authority do not justify deleting a valid case. Clarify acceptance omissions through current requirements rather than measuring only test count.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use testing.md. Preserve the `cases` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/verify.md

@@ -17,3 +17,9 @@ The agreed execution work is accounted for with traceable results. This run can
 Unavailable environment or authority stays explicit with a recovery action. Do not lower criteria, skip assertions or mark a case passed because a command exited successfully.
 
 Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
+
+## Artifact contract
+
+Use testing.md. Preserve the `runs` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+
+Append RUN records in testing.md, referencing versioned TC and exact objects. Evidence goes in .aimship/evidence/; no installation diagnostics or repeated state output in ordinary deliveries.

package/skills/aimship/references/templates/change-log.md

@@ -0,0 +1,14 @@
+# change-log
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="changes"></a>
+## Important changes
+
+CHG, reason/decision source, before/after, affected IDs/objects, actions/results and remaining work. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="remaining"></a>
+## Unfinished impact handling
+
+One decision stays one record; no edit audit. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/diagnosis.md

@@ -0,0 +1,39 @@
+# diagnosis
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="goals"></a>
+## Investigation goal and scope
+
+Commission and authorized scope. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="symptoms"></a>
+## Observed and expected behavior
+
+Facts versus hypotheses. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="environment"></a>
+## Environment and reproduction
+
+Exact versions and reproducible conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="evidence"></a>
+## Checks and evidence
+
+Operations, observations and source refs. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="causes"></a>
+## Cause assessment
+
+Confirmed causes versus unverified hypotheses. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="unknowns"></a>
+## Impact and unknowns
+
+Dependent work and recovery conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="conclusion"></a>
+## Conclusion and next action
+
+Investigation endpoint is not automatically repair completion. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/handoff.md

@@ -0,0 +1,34 @@
+# handoff
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="goals"></a>
+## Current goal comparison
+
+REQ/AC and actual results, including explicit goal changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="artifacts"></a>
+## Artifacts, repositories and versions
+
+Links, actual checkout/worktree, branch/commit and uncommitted paths; no Git uses file digests. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="usage"></a>
+## Usage
+
+Actual commands and entry points. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="results"></a>
+## Review and verification
+
+Scopes, versions, results and evidence. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="limits"></a>
+## Limitations and remaining work
+
+Unverified work and recovery conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="outcomes"></a>
+## Acceptance, integration, release and continuation
+
+Independent facts; prepared version is not a release. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/plan.md

@@ -0,0 +1,34 @@
+# plan
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="basis"></a>
+## Implementation basis and scope
+
+Current requirements, design, contracts and actual repositories. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="batches"></a>
+## Batches and dependencies
+
+B ID, goal, dependencies and integration arrangement. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="tasks"></a>
+## Tasks and completion criteria
+
+TASK, batch, REQ/AC or risk, repository ID, file/module, planned change, completion criteria, status, artifact ref. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="validation"></a>
+## Review and independent verification arrangement
+
+Each batch review, overall review then independent verification; no per-batch full test gates. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="execution"></a>
+## Task status and execution records
+
+Actual changes and object versions by TASK/B; preserve original plan and distinguish pre-existing changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="remaining"></a>
+## Deviations, blockers and remaining work
+
+Unfinished effects and recovery, not a second stage ledger. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/prd.md

@@ -0,0 +1,39 @@
+# prd
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="info"></a>
+## Document information and sources
+
+Identify this delivery, revision and adopted inputs. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="goals"></a>
+## Background, goals and non-goals
+
+Separate known facts, requirements and assumptions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="scope"></a>
+## Scope, engineering objects and endpoint
+
+Included/excluded work, repository IDs, authorization and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="requirements"></a>
+## Requirements and behavior
+
+REQ, type, actor/object, trigger/precondition, behavior, observable result, boundaries/errors, source and AC. Shared business rules, access control (even one role), performance and reliability need independent identity when independently testable. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="states"></a>
+## States, interaction and recovery
+
+Allowed transitions, terminal states, errors and recovery; say why inapplicable. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="acceptance"></a>
+## Acceptance criteria
+
+AC, requirement reference, condition, operation, decidable expected result. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="arrangement"></a>
+## Dependencies, questions and stage arrangement
+
+Selected order, artifact locations/reuse, dependencies, Q with impact/status/decision source. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/review.md

@@ -0,0 +1,19 @@
+# review
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="basis"></a>
+## Review basis and scope
+
+Exact repositories/objects, baseline and differences. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="reviews"></a>
+## Review records
+
+REV, batch/overall/repair scope, TASK/REQ/AC, reviewer/date, findings, dispositions and recheck conclusions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="conclusion"></a>
+## Open findings and current conclusion
+
+Preserve historical findings and old object basis; review is not execution. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/scope.md

@@ -0,0 +1,39 @@
+# scope
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="info"></a>
+## Document information and source versions
+
+Delivery identity and adopted versions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="goals"></a>
+## Goal, engineering objects and endpoint
+
+Actual repository IDs, authorized objects and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="adoption"></a>
+## Source mapping and adopted scope
+
+Source/version/original ID or section, adoption decision, requirement reference, AC and gaps; do not copy the full PRD. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="exclusions"></a>
+## Exclusions and constraints
+
+Explicitly delimit this commission. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="decisions"></a>
+## Conflicts, gaps and supplementary decisions
+
+Preserve sources; identify decision authority and pending source updates. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="acceptance"></a>
+## Acceptance basis
+
+AC, requirement/source identity, conditions, actions and expected results. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="arrangement"></a>
+## Authorization, questions and stage arrangement
+
+Selected order, artifact locations/reuse, permissions and open Q. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/tech-design.md

@@ -0,0 +1,39 @@
+# tech-design
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="basis"></a>
+## Basis and engineering context
+
+Current requirements and actual engineering constraints. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="architecture"></a>
+## Architecture and key flows
+
+Ordered explanation or diagram of the important flow. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="modules"></a>
+## Modules and interaction implementation
+
+Repository ID, responsibility, actual path, new/change, requirement refs; entry/state/data flow for interaction. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="data"></a>
+## Data, interfaces and SQL
+
+Structures, indexes, consistency, contract authority, database type/version/schema basis, SQL order and execution boundary. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="errors"></a>
+## Errors and nonfunctional design
+
+Recovery, access, performance, observability, cache/messages when relevant. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="risks"></a>
+## Tradeoffs and risks
+
+Reasons, alternatives, compatibility and technical risks. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="coverage"></a>
+## Requirement coverage and questions
+
+REQ/AC to module/operation/SQL section and unresolved Q. Replace guidance with actual content; explain inapplicability, never prefill a result.
+

package/skills/aimship/references/templates/testing.md

@@ -0,0 +1,34 @@
+# testing
+
+Delivery: <deliveryId from init>; document revision: <revision>.
+
+<a id="basis"></a>
+## Basis and scope
+
+Current AC and risks; adopted cases location/version if verify-only. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="environment"></a>
+## Environment, data and execution conditions
+
+Tools, permissions, commands and unavailable conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="cases"></a>
+## Test cases
+
+TC, case version, REQ/AC or risk, type/level, preconditions, operations, concrete expected result, method/entry. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="coverage"></a>
+## Coverage and verification arrangement
+
+AC, requirements, TC, gaps and execution group/order. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="runs"></a>
+## Execution and retest records
+
+RUN, TC@version, exact code/build or document object, command/operation, assertions, actual results and evidence. Not executed until actually run; append failures/retests. Replace guidance with actual content; explain inapplicability, never prefill a result.
+
+<a id="conclusion"></a>
+## Defects, current conclusion and remaining work
+
+Separate passed, failed, blocked and unexecuted; explain applicability after change. Replace guidance with actual content; explain inapplicability, never prefill a result.
+