@sha3/code 1.0.0

package/prompts/init.prompt.md

@@ -0,0 +1,24 @@
+This is phase 1 of the init workflow. Plan first, then continue yourself into phase 2 unless you are blocked.
+
+Read only the minimum context needed to produce an execution plan:
+
+- `PROMPT.md`
+- `AGENTS.md`
+- `ai/contract.json`
+- `ai/rules.md`
+- `skills/init-workflow/SKILL.md`
+- `skills/feature-shaping/SKILL.md`
+- `skills/simplicity-audit/SKILL.md`
+- `skills/change-synchronization/SKILL.md`
+- the assistant-specific adapter in `ai/`, if present
+
+Load optional skills only if the request in `PROMPT.md` triggers them:
+
+- `skills/test-scope-selection/SKILL.md` for meaningful behavior changes
+- `skills/readme-authoring/SKILL.md` when `README.md` must change
+- `skills/http-api-conventions/SKILL.md` for `node-service` projects or HTTP endpoint work
+
+Produce a compact internal implementation plan with the minimum files that need inspection next, note any assumptions that could change the design, and keep the read set small.
+
+Do not edit files in this phase, do not run verification yet, and do not restate the full contract.
+After planning, continue directly into `prompts/init-phase-2-implement.md` without waiting for the user unless a real blocker remains.

package/prompts/refactor-contract.md

@@ -0,0 +1,26 @@
+## Refactor Contract
+
+Use this contract during rebuild and verification phases, not as phase-1 analysis input unless the plan proves it is necessary.
+
+This workflow is a refactor, not a migration-by-copy. You MUST load `skills/refactor-workflow/SKILL.md` and follow it as the primary procedural guide for execution order, prohibitions, and reporting.
+You MUST also load `skills/feature-shaping/SKILL.md`, `skills/simplicity-audit/SKILL.md`, and `skills/change-synchronization/SKILL.md` as part of the default refactor workflow.
+
+## Requirements
+
+- You MUST preserve only the contracts explicitly marked for preservation.
+- You MUST use the snapshot under `.code-standards/refactor-source/latest/` as reference, not as a structure to copy blindly.
+- You MUST treat the freshly regenerated managed files in the project root as authoritative.
+- If the refactor changes meaningful behavior, you MUST load `skills/test-scope-selection/SKILL.md`.
+- If the refactor rebuilds or documents HTTP transport behavior, you MUST load `skills/http-api-conventions/SKILL.md`.
+- If the refactor rewrites `README.md`, you MUST load `skills/readme-authoring/SKILL.md`.
+- You MUST execute `npm run check` yourself before finishing.
+- If `npm run check` fails, you MUST fix the issues and rerun it until it passes.
+- As the final step, you MUST create or update `SCAFFOLD-FEEDBACK.md` in the project root with concrete feedback about scaffold problems, unclear instructions, friction, missing patterns, and suggested improvements.
+
+Finish with:
+
+- changed files
+- preserved contracts checklist
+- intentionally broken or non-preserved items, if any
+- proof that `npm run check` passed
+- confirmation that `SCAFFOLD-FEEDBACK.md` was created or updated

package/prompts/refactor-phase-2-rebuild.md

@@ -0,0 +1,25 @@
+This is phase 2 of the refactor workflow. Rebuild the domain code now.
+
+Read only:
+
+- `PROMPT.md`
+- `prompts/refactor-contract.md`
+- the plan you produced in phase 1
+- the files you identified as necessary during phase 1
+
+Load optional skills only if they are actually needed for the approved plan:
+
+- `skills/test-scope-selection/SKILL.md` for meaningful behavior changes
+- `skills/http-api-conventions/SKILL.md` when transport behavior is being preserved or rebuilt
+- `skills/readme-authoring/SKILL.md` when `README.md` changes
+
+Execution rules:
+
+- Follow `prompts/refactor-contract.md` and `skills/refactor-workflow/SKILL.md`.
+- Preserve only the explicit contracts and preservation decisions.
+- Use `.code-standards/refactor-source/latest/` as reference material, not as a structure to copy.
+- Keep the fresh scaffold authoritative and simplify where preservation does not require legacy complexity.
+- Rewrite `README.md` only after behavior is stable.
+- Do not stop at the end of this phase unless blocked.
+
+At the end of this phase, summarize internally what was rebuilt, note any preserved contracts still at risk, and continue directly into `prompts/refactor-phase-3-verify.md`.

package/prompts/refactor-phase-3-verify.md

@@ -0,0 +1,24 @@
+This is phase 3 of the refactor workflow. Verify and close the task.
+
+Read only:
+
+- `PROMPT.md`
+- `prompts/refactor-contract.md`
+- your phase 2 rebuild summary
+- the files changed during the rebuild
+- the latest command output that shows current verification status
+
+Execution rules:
+
+- Run the remaining required verification, including `npm run check`.
+- If verification fails, fix the issues and rerun until it passes.
+- Create or update `SCAFFOLD-FEEDBACK.md` as the final project artifact.
+- Keep the final response concise and evidence-based.
+
+Your final response must include:
+
+1. Changed files.
+2. The preserved contracts checklist.
+3. Intentionally non-preserved items, if any.
+4. Proof that `npm run check` passed.
+5. Confirmation that `SCAFFOLD-FEEDBACK.md` was created or updated.

package/prompts/refactor.prompt.md

@@ -0,0 +1,26 @@
+This is phase 1 of the refactor workflow. Analyze first, then continue yourself into phase 2 unless you are blocked.
+
+Read only the minimum context needed to plan the rewrite:
+
+- `PROMPT.md`
+- `AGENTS.md`
+- `ai/contract.json`
+- `ai/rules.md`
+- `skills/refactor-workflow/SKILL.md`
+- `skills/feature-shaping/SKILL.md`
+- `skills/simplicity-audit/SKILL.md`
+- `skills/change-synchronization/SKILL.md`
+- `.code-standards/refactor-source/public-contract.json`
+- `.code-standards/refactor-source/preservation.json`
+- `.code-standards/refactor-source/analysis-summary.md`
+
+Load optional skills only if the request in `PROMPT.md` triggers them:
+
+- `skills/test-scope-selection/SKILL.md` for meaningful behavior changes
+- `skills/http-api-conventions/SKILL.md` when transport behavior is being preserved or rebuilt
+- `skills/readme-authoring/SKILL.md` when `README.md` must change
+
+Produce an internal summary of the preserved contracts and rewrite risks, create a compact rebuild plan with the minimum legacy files worth opening next, and keep the read set small.
+
+Do not edit files in this phase, do not run final verification yet, and do not restate the full contract.
+After planning, continue directly into `prompts/refactor-phase-2-rebuild.md` without waiting for the user unless a real blocker remains.

package/resources/ai/AGENTS.md

@@ -0,0 +1,18 @@
+# AI Template System Entry Point
+
+This directory stores profile-aware templates used by `code-standards init`.
+
+Template resolution order:
+
+1. `resources/ai/templates/agents.project.template.md`
+2. `resources/ai/templates/skills.index.template.md`
+3. `resources/ai/templates/skills/*/SKILL.md`
+4. `resources/ai/templates/rules/*.md`
+5. `resources/ai/templates/adapters/*.template.md`
+
+Rendering rules:
+
+- Render from validated profile data (`profiles/schema.json`).
+- Use deterministic token replacement.
+- Preserve stable section order in generated `AGENTS.md`.
+- Keep assistant adapters aligned with the generated project contract.

package/resources/ai/adapters/codex.md

@@ -0,0 +1,5 @@
+# Codex Adapter
+
+- Implement directly and keep changes minimal.
+- Prefer deterministic commands and explicit validation.
+- Use `npm run check` as the completion gate.

package/resources/ai/adapters/copilot.md

@@ -0,0 +1,5 @@
+# Copilot Adapter
+
+- Generate ESM-first TypeScript code.
+- Prefer small composable functions.
+- Add or update tests for behavioral changes.

package/resources/ai/adapters/cursor.md

@@ -0,0 +1,5 @@
+# Cursor Adapter
+
+- Use project-local configs as the primary source of style truth.
+- Avoid introducing structure that does not match `src/` and `test/` layout.
+- Validate with `npm run check`.

package/resources/ai/adapters/windsurf.md

@@ -0,0 +1,5 @@
+# Windsurf Adapter
+
+- Keep edits aligned with @sha3/code exports.
+- Run local enforcement scripts instead of relying on remote CI.
+- Preserve assistant files (`AGENTS.md`, `ai/*.md`) unless explicitly removed by user.

package/resources/ai/contract.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sha3.dev/code/contract.schema.json",
+  "title": "Generated AI Contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["formatVersion", "generatedByVersion", "project", "profile", "managedFiles", "rules"],
+  "properties": {
+    "formatVersion": { "type": "string", "const": "v2" },
+    "generatedByVersion": { "type": "string", "minLength": 1 },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "template", "withAiAdapters"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "template": { "type": "string", "enum": ["node-lib", "node-service"] },
+        "withAiAdapters": { "type": "boolean" }
+      }
+    },
+    "profile": { "type": "object" },
+    "managedFiles": { "type": "array", "minItems": 2, "items": { "type": "string" } },
+    "rules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "title",
+          "summary",
+          "severity",
+          "kind",
+          "deterministic",
+          "verificationMode",
+          "verificationSource",
+          "implementedBy",
+          "requiresContext",
+          "confidence",
+          "appliesTo",
+          "enforcedBy",
+          "examples"
+        ],
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string" },
+          "summary": { "type": "string" },
+          "severity": { "type": "string", "enum": ["error", "warning", "audit"] },
+          "kind": { "type": "string" },
+          "deterministic": { "type": "boolean" },
+          "verificationMode": { "type": "string", "enum": ["deterministic", "heuristic", "audit"] },
+          "verificationSource": { "type": "string", "enum": ["ast", "text", "filesystem", "package-json", "readme", "git-diff", "combined"] },
+          "implementedBy": { "type": "array", "items": { "type": "string" } },
+          "requiresContext": { "type": "string", "enum": ["none", "changed-files", "full-project"] },
+          "confidence": { "type": "string", "enum": ["high", "medium"] },
+          "appliesTo": { "type": "array", "items": { "type": "string" } },
+          "enforcedBy": { "type": "array", "items": { "type": "string" } },
+          "examples": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["good", "bad"],
+            "properties": { "good": { "type": "array", "items": { "type": "string" } }, "bad": { "type": "array", "items": { "type": "string" } } }
+          }
+        }
+      }
+    }
+  }
+}