aimship 0.1.0-preview.4 → 0.1.0-preview.8

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,35 @@
+# 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.
+
+<!-- Review guidance: retain the fixed outline. Technical design precedes interface/SQL production; test cases precede planning. Self-check and explicit document approval are separate from stage done. For plan/testing, keep execution records after execution/runs respectively. -->

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,40 @@
+# 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.
+
+<!-- Review guidance: retain the fixed outline. Technical design precedes interface/SQL production; test cases precede planning. Self-check and explicit document approval are separate from stage done. For plan/testing, keep execution records after execution/runs respectively. -->

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

@@ -0,0 +1,35 @@
+# 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.
+
+<!-- Review guidance: retain the fixed outline. Technical design precedes interface/SQL production; test cases precede planning. Self-check and explicit document approval are separate from stage done. For plan/testing, keep execution records after execution/runs respectively. -->