create-issflow 1.8.1 → 1.9.1

package/template/.issflow/flow-config.json

@@ -0,0 +1,12 @@
+{
+  "context": {
+    "window": 1000000,
+    "warnPct": 60,
+    "gatePct": 78,
+    "_note": "window = this session's real context window. THIS repo runs Opus 4.8 [1m] but the transcript records model id as 'claude-opus-4-8' (no [1m] tag), so auto-detect (window:0) would wrongly assume 200000 and false-gate around 156k. Set it explicitly here. Kit template default stays 200000 — override per your model. warnPct = soft non-blocking nudge. gatePct = hard PreToolUse block on NEW build work (Edit/Write to SOURCE files). Checkpoint paths (docs/**, STATE/ISSUES/snapshots) and all Bash (git) are never blocked; Task delegation is never gated (a subagent isolates noise and shrinks orchestrator context)."
+  },
+  "sprint": {
+    "defaultCapacity": 8,
+    "_note": "Sprint layer (/sprint). defaultCapacity = points committed to the FIRST sprint before any velocity history exists; later sprints size to the rolling completed-velocity average. Optional — /sprint falls back to 8 if this block is absent."
+  }
+}

package/template/{.claude → .issflow}/hooks/context-guard.js

@@ -27,7 +27,7 @@ process.stdin.on('end', () => {
 function run(evt) {
   const projectDir = process.env.CLAUDE_PROJECT_DIR || evt.cwd || '.';
   let ctx;
-  try { ctx = require(path.join(projectDir, '.claude/hooks/lib/ctx.js')); } catch (_) { return silent(); }
+  try { ctx = require(path.join(projectDir, '.issflow/hooks/lib/ctx.js')); } catch (_) { return silent(); }
   const cfg = ctx.loadConfig(projectDir);
   const warn = cfg.warnPct || 60;
   const gate = cfg.gatePct || 78;
@@ -89,7 +89,7 @@ function gateReason(u, gate) {
     '  2) /synthesize  (อัด handoff docs — subagent นี้ไม่ถูก block)',
     '  3) /clear       (session ใหม่ บางลง)',
     'build ต่อหลัง clear. กลาง irreversible op? ใช้ Bash ปิดให้จบก่อน clear.',
-    'ปลดล็อกชั่วคราว: เพิ่ม gatePct ใน .claude/flow-config.json.',
+    'ปลดล็อกชั่วคราว: เพิ่ม gatePct ใน .issflow/flow-config.json.',
   ].join('\n');
 }
 

package/template/{.claude → .issflow}/hooks/lib/ctx.js

@@ -21,7 +21,7 @@ function inferWindow(model) {
 // Read project flow config; returns the `context` block or {}.
 function loadConfig(projectDir) {
   try {
-    const cfg = JSON.parse(fs.readFileSync(projectDir + '/.claude/flow-config.json', 'utf8'));
+    const cfg = JSON.parse(fs.readFileSync(projectDir + '/.issflow/flow-config.json', 'utf8'));
     return (cfg && cfg.context) || {};
   } catch (_) { return {}; }
 }

package/template/{.claude → .issflow}/hooks/plan-gate.js

@@ -50,7 +50,7 @@ function run(evt) {
 
   // writable while PENDING: planning + docs + kit + repo meta — never product source.
   const ALLOW = [
-    /^docs\//, /^\.claude\//, /^\.cursor\//, /^\.github\//, /^\.aider/, /^\.git/,
+    /^docs\//, /^\.issflow\//, /^\.claude\//, /^\.cursor\//, /^\.github\//, /^\.aider/, /^\.git/,
     /^(README|AGENTS|CLAUDE|GEMINI|CHANGELOG|LICENSE)[^/]*$/i, /^[^/]+\.md$/,
   ];
   if (ALLOW.some((re) => re.test(rel))) return silent();

package/template/{.claude → .issflow}/hooks/session-start.js

@@ -90,7 +90,7 @@ if (idx !== null) {
 }
 
 // 3d. shared KB — pull latest + load snapshot
-const KB_CONFIG = '.claude/kb-config.json';
+const KB_CONFIG = '.issflow/kb-config.json';
 let kbActive = false;
 if (exists(KB_CONFIG)) {
   let cfg = {}; try { cfg = JSON.parse(read(KB_CONFIG) || '{}'); } catch (_) {}
@@ -126,7 +126,7 @@ if (exists(KB_CONFIG)) {
     kbActive = true;
   } else {
     emit('## Shared KB: configured but path not found (' + (cfg.kb_path || '') + ')');
-    emit('Fix kb_path in .claude/kb-config.json (or re-run: npx create-issflow).');
+    emit('Fix kb_path in .issflow/kb-config.json (or re-run: npx create-issflow).');
     emit('');
   }
 }

package/template/{.claude → .issflow}/istartsoft-flow/METHODOLOGY.md

@@ -1,11 +1,10 @@
 # iStartSoftFlow — portable agent methodology (single source of truth)
 
-> **The iStartSoft execution loop.** Lives under `.claude/istartsoft-flow/` as
-> part of the **portable kit**. The directory name `.claude/` is a **host
-> convention** (several agents load commands/hooks from that path) — not
-> Claude-only branding. Primary human entry is root **`AGENTS.md`** (open
-> standard). `CLAUDE.md` / `GEMINI.md` / … are thin host adapters that point
-> here; they do NOT replace this file.
+> **The iStartSoft execution loop.** Lives under `.issflow/istartsoft-flow/` as
+> part of the **portable kit** (tool-agnostic SoT). Primary human entry is root
+> **`AGENTS.md`** (open standard). `CLAUDE.md` / `GEMINI.md` / `.cursor/` / … are
+> thin host adapters that point here; they do NOT replace this file. Claude Code
+> also gets a `.claude/` **mirror** of this kit (host discovery only).
 >
 > The kit is **stack-agnostic and tool-agnostic**: it pins a *process*, not a
 > *stack*. Declare your stack (language, framework, infra, auth, test + E2E
@@ -110,10 +109,12 @@ from idea to closeout:
    the proposal estimates *these* phases.
 5. **Proposal & estimate (OPTIONAL — depends on the job)** — for client / quoted
    work, `/propose` reads OVERVIEW + PLAN → `docs/PROPOSAL.md` + a rendered
-   `docs/proposal.html`: scope, phase breakdown, effort + cost estimate, timeline,
-   assumptions, with a **client sign-off gate** before build. **Ask rate +
-   contingency in chat** when missing — the kit stores **no** default rate (rates
-   are confidential). Client docs show **totals only** (never rate or contingency %).
+   `docs/proposal.html`: scope, **package** rows on the signable A4 page (not every
+   PLAN phase), effort + cost estimate, timeline, assumptions, and a screen
+   appendix in the **same HTML** after a page-break, with a **client sign-off gate**
+   before build. **Ask rate + contingency in chat** when missing — the kit stores
+   **no** default rate (rates are confidential). Client docs show **totals only**
+   (never rate or contingency %).
    Internal / personal projects skip straight from plan to build (and may set
    design/architecture gates to `n/a`).
 6. **Design + architecture gates (rule 15 — after proposal, before build)** —
@@ -171,7 +172,7 @@ documented feature branch out, near-100% hands-off. Humans remain at exactly thr
 points: **approve the doc** (entry) · **UAT** (`/uat` against the generated
 TEST-PLAN) · **merge**. Production deploy is never in this lane (`/release` owns it).
 
-Pipeline (canonical body in `.claude/commands/feature.md`):
+Pipeline (canonical body in `.issflow/commands/feature.md`):
 spec completion → adversarial doc-review → mini-plan → contract surface probe →
 build loop (the `/phase` machinery, feature-scoped) → review & harden → manual
 test plan → docs + token stamp + summary → memory queue → delivery.
@@ -182,13 +183,13 @@ Three layers make "hands-off" real — each uses the mechanism suited to its job
    through the standard roles under AUTO; the circuit breaker, rules 11/12, and
    blind TDD apply unchanged.
 2. **Must-happen-every-time → a lifecycle hook.** `docs/features/<slug>/GATES.md`
-   is the run's gate checklist; the `Stop` hook (`.claude/hooks/feature-gate.js`)
+   is the run's gate checklist; the `Stop` hook (`.issflow/hooks/feature-gate.js`)
    BLOCKS session end while the feature is `(active)` in STATE with unchecked
    gates — and it verifies ARTIFACTS, not ticks: a checked `test-plan` /
    `mini-plan` / `contract-probe` / `token-stamp` / `summary` / `memory-queued`
    gate whose deliverable is missing on disk blocks too (also re-checked in the
    `(done)` state). A prompt can be ignored; the hook cannot. Rule 13 gets the
-   same treatment: the `PreToolUse` plan gate (`.claude/hooks/plan-gate.js`)
+   same treatment: the `PreToolUse` plan gate (`.issflow/hooks/plan-gate.js`)
    denies source Edit/Write while `docs/PLAN.md` reads `> Approval: PENDING`
    (docs/kit paths stay writable; an active feature lane is exempt — its doc
    approval is its own scoped gate). Hosts without lifecycle hooks run these as
@@ -196,14 +197,14 @@ Three layers make "hands-off" real — each uses the mechanism suited to its job
 3. **No-human-at-the-keyboard → a headless runner.** `ISSFLOW_HEADLESS=1` tells the
    lane no human is present: every hard-stop degrades to a `BLOCKED.md` report +
    clean exit — never a guess. Two shipped runners (`create-issflow --ci|--docker`,
-   sources in `.claude/templates/automation/`):
+   sources in `.issflow/templates/automation/`):
    - **GitHub Actions** — label an issue `feature:approved` (or dispatch with a doc
      path); the workflow runs the lane on an ephemeral runner.
    - **Docker** — `node scripts/feature-docker.js <FEATURE.md>` builds
      `Dockerfile.issflow` and runs the lane in an unprivileged container with the
      repo mounted; the container is the sandbox that makes a skip-permissions run
      acceptable. Works for any host that ships a headless CLI. The runner image
-     MUST contain Node ≥ 18 — the lifecycle hooks are `node .claude/hooks/*.js`,
+     MUST contain Node ≥ 18 — the lifecycle hooks are `node .issflow/hooks/*.js`,
      and without node they die silently (no session context, no feature gate).
      The shipped image is Node-based and the wrapper preflights `node` before
      every run, including bring-your-own images (`ISSFLOW_IMAGE=<name>`).
@@ -256,7 +257,7 @@ the planning phase when a project needs that rigor, then drive delivery here.
 ## Roles (fresh-context workers)
 
 Each role is a fresh-context worker mapped to a named Claude Code subagent in
-`.claude/agents/*.md`. A worker dumps its noise to a file and returns only a
+`.issflow/agents/*.md`. A worker dumps its noise to a file and returns only a
 terse summary + path. Workers cannot address the user — only the orchestrator
 can. Escalation is at most two hops.
 
@@ -284,7 +285,7 @@ can. Escalation is at most two hops.
 
 The orchestrator ROUTES. It does not implement or debug.
 
-**Model routing (per-role tiers).** Each role's `.claude/agents/<role>.md` pins a
+**Model routing (per-role tiers).** Each role's `.issflow/agents/<role>.md` pins a
 `model:` tier suited to its work, so the RIGHT model runs each task by default:
 
 | Role | `model:` | Why |
@@ -302,7 +303,7 @@ support run everything on the session model (graceful degrade).
 
 ## Procedures (the slash-command set)
 
-Named procedures, each with a canonical body in `.claude/commands/<name>.md`.
+Named procedures, each with a canonical body in `.issflow/commands/<name>.md`.
 
 **Lane routing — which entry point for which job:**
 
@@ -334,7 +335,7 @@ surface or need its own acceptance criteria? -> `/feature`. Otherwise `/quick`.
   one APPROVED Feature doc → spec completion → adversarial doc-review → mini-plan
   → contract probe → build loop → review & harden → manual test plan →
   docs/stamps/memory → delivery. `new` scaffolds the doc from
-  `.claude/templates/FEATURE-template.md`; `from-story` transforms a BMAD/iSSM
+  `.issflow/templates/FEATURE-template.md`; `from-story` transforms a BMAD/iSSM
   story into a PENDING doc (approval stays human). Gate checklist in
   `docs/features/<slug>/GATES.md`, enforced by the `Stop` hook with artifact
   verification. Headless-capable (CI / Docker, `ISSFLOW_HEADLESS=1`). See "Feature lane".
@@ -407,7 +408,7 @@ At the start of every session, before any other work, surface:
    surface its goal + burndown from `docs/sprints/sprint-<n>.md`.
 3. open items in `docs/ISSUES.md`.
 4. `docs/research/INDEX.md` (research map) + infra/auth status.
-5. shared KB: pull latest + load `docs/.kb-snapshot.md` if `.claude/kb-config.json`
+5. shared KB: pull latest + load `docs/.kb-snapshot.md` if `.issflow/kb-config.json`
    exists.
 6. a one-line reminder of the hard rules below.
 
@@ -611,7 +612,7 @@ fail the other.
 
 ## Shared KB (optional)
 
-If `.claude/kb-config.json` exists, the SESSION-OPEN ritual pulls the KB and loads
+If `.issflow/kb-config.json` exists, the SESSION-OPEN ritual pulls the KB and loads
 a snapshot to `docs/.kb-snapshot.md`. The researcher checks the snapshot (step 0)
 before any web search. Run `store-wisdom` to promote resolved issues + research to
 the KB. The kit works normally without a KB.
@@ -621,13 +622,15 @@ the KB. The kit works normally without a KB.
 ## File contract
 
 - `docs/PRD.md` — crystallised product requirements (or your BMAD/iSSM stories).
-- `docs/PROPOSAL.md` — scope + phase breakdown + effort/cost totals + assumptions
-  + sign-off. Versioned; client-safe commercial baseline (no rate / contingency %).
+- `docs/PROPOSAL.md` — scope + package rows + effort/cost totals + assumptions
+  + screen-appendix page range + sign-off. Versioned; client-safe commercial
+  baseline (no rate / contingency %).
 - `docs/proposal.html` — the client-facing proposal, rendered from PROPOSAL.md via
-  `.claude/templates/proposal.html`, in the project language; print-ready (PDF).
+  `.issflow/templates/proposal.html`, in the project language; page 1 is the
+  signable A4 sheet, then screen frames in the same file (print A4).
 - `docs/UX-PACK.md` · `docs/ARCHITECTURE.md` — pre-build design/arch frames
-  (rule 15); templates under `.claude/templates/`.
-- `.claude/templates/` — document templates (proposal.html, UX-PACK, ARCHITECTURE,
+  (rule 15); templates under `.issflow/templates/`.
+- `.issflow/templates/` — document templates (proposal.html, UX-PACK, ARCHITECTURE,
   CR, FEATURE, …) the commands render into `docs/`.
 - `docs/CHANGES.md` — change-order log (append-only): each scope change with its
   impact, effort/cost delta, new total, and approval status. The commercial audit trail.
@@ -645,14 +648,14 @@ the KB. The kit works normally without a KB.
   `BLOCKED.md` (headless blocker reports).
 - `docs/WISDOM-QUEUE.md` — auto-appended wisdom candidates from feature runs;
   `/store-wisdom` reads it before pushing to the shared KB (push stays human).
-- `.claude/templates/automation/` — headless-runner sources (GitHub Actions ·
+- `.issflow/templates/automation/` — headless-runner sources (GitHub Actions ·
   Dockerfile · docker wrapper), materialized by `create-issflow --ci` /
   `--docker` as `.github/workflows/issflow-feature.yml` +
   `.github/workflows/issflow-goal.yml` (cron-ready, disarmed by default) ·
   `Dockerfile.issflow` · `scripts/feature-docker.js`.
 - `docs/GOALS.md` — the goal layer's state: one `## G<n>` block per goal
   (Done-when · Budget · `Approved:` line · progress ticks). Maintained by `/goal`.
-- `.claude/templates/FEATURE-template.md` — the Feature-doc form `/feature new`
+- `.issflow/templates/FEATURE-template.md` — the Feature-doc form `/feature new`
   scaffolds (Approval/Automation headers + spec sections).
 - `docs/STATE.md` — current position. Small. Rewritten, not appended. Includes
   `plan:`, `design:`, `architecture:` gate pointers (approved · PENDING · n/a).
@@ -686,20 +689,20 @@ the KB. The kit works normally without a KB.
 - `tests/phase-<n>/` — phase-local test suites.
 - `tests/regression/` — cross-phase contract tests (the regression corpus). Run by
   `scripts/regression.sh` (default mock; `--real` runs the real corpus).
-- `.claude/skills/ux-design/` — the UX cookbook + wireframe baseline (read on
+- `.issflow/skills/ux-design/` — the UX cookbook + wireframe baseline (read on
   demand for any UI work).
-- `.claude/skills/security/` — the Secure SDLC cookbook + threat-modeling /
+- `.issflow/skills/security/` — the Secure SDLC cookbook + threat-modeling /
   secure-coding / pentest / standards references (read on demand for security work).
-- `.claude/skills/code-standards/` — naming-per-language + architecture cookbook
+- `.issflow/skills/code-standards/` — naming-per-language + architecture cookbook
   (read on demand for any coding / scaffolding / structure decision).
-- `.claude/kb-config.json` — shared KB path + remote (optional).
+- `.issflow/kb-config.json` — shared KB path + remote (optional).
 - `docs/.kb-snapshot.md` — KB INDEX loaded this session (auto-generated, gitignored).
 
 -----
 
 ## Capability matrix (which host gets what)
 
-Single-source kit: **`.claude/` tree** (portable) + **this file** (rules) + root
+Single-source kit: **`.issflow/` tree** (portable) + **this file** (rules) + root
 **`AGENTS.md`** (open-standard entry). `create-issflow --tool=<host>` (omit =
 all) writes adapters; unsupported features degrade to model-run rituals, never
 silently vanish. Assets are the same everywhere — only the *wiring* differs.
@@ -707,11 +710,11 @@ silently vanish. Assets are the same everywhere — only the *wiring* differs.
 | Host | Entry file | Commands | Subagents | Lifecycle hooks | Shared KB |
 |------|-----------|----------|-----------|-----------------|-----------|
 | **Any AGENTS.md host** | `AGENTS.md` | read as reference | model-run | model-run | yes |
-| **Codex CLI** | `AGENTS.md` (native) | `.claude/commands/` (read as prompts) | read as reference | model-run | yes |
-| **Cursor** | `.cursor/rules/` + `AGENTS.md` | `.cursor/commands/` | reads `.claude/agents/` | `.cursor/hooks.json` (sessionStart · subagentStop) | yes |
-| **Gemini CLI** | `GEMINI.md` + `AGENTS.md` | `.claude/commands/` (read as prompts) | read as reference | model-run | yes |
+| **Codex CLI** | `AGENTS.md` (native) | `.issflow/commands/` (read as prompts) | read as reference | model-run | yes |
+| **Cursor** | `.cursor/rules/` + `AGENTS.md` | `.cursor/commands/` | reads `.issflow/agents/` | `.cursor/hooks.json` (sessionStart · subagentStop) | yes |
+| **Gemini CLI** | `GEMINI.md` + `AGENTS.md` | `.issflow/commands/` (read as prompts) | read as reference | model-run | yes |
 | **Aider** | `.aider.conf.yml` → `AGENTS.md` | read as reference | model-run | model-run | yes |
-| **Claude Code** | `CLAUDE.md` (`@AGENTS.md`) + `.claude/` | `.claude/commands/` | native | SessionStart · PreToolUse (context watchdog + plan gate) · PreCompact · SubagentStop · Stop | yes |
+| **Claude Code** | `CLAUDE.md` (`@AGENTS.md`) + `.claude/` mirror | `.claude/commands/` (mirror of `.issflow/`) | native | SessionStart · PreToolUse (context watchdog + plan gate) · PreCompact · SubagentStop · Stop — hooks run from `.issflow/` | yes |
 
 "model-run" = the host can't automate the ritual, so the model performs it by hand
 (SESSION-OPEN at the top of each session; the COMPRESS snapshot before a reset).

package/template/{.claude → .issflow}/templates/automation/Dockerfile

@@ -18,7 +18,7 @@ RUN apt-get update \
     && rm -rf /var/lib/apt/lists/* \
     && npm install -g @anthropic-ai/claude-code
 
-# sanity: the kit's lifecycle hooks are `node .claude/hooks/*.js` — a runner
+# sanity: the kit's lifecycle hooks are `node .issflow/hooks/*.js` — a runner
 # image WITHOUT node runs claude fine but every hook silently dies (no
 # session-start context, no feature gate). Fail the build, not the run.
 RUN node --version && claude --version

package/template/{.claude → .issflow}/templates/automation/feature-docker.js

@@ -34,7 +34,7 @@ const run = (cmd, args, opts = {}) => spawnSync(cmd, args, { stdio: 'inherit', .
 if (!doc) die('usage: node scripts/feature-docker.js <path/to/FEATURE.md> [--rebuild] [--worktree]');
 const repo = process.cwd();
 if (!fs.existsSync(path.join(repo, doc))) die(`Feature doc not found: ${doc} (run from the repo root)`);
-if (!fs.existsSync(path.join(repo, '.claude', 'commands', 'feature.md'))) die('no .claude/commands/feature.md here — run from a repo with the kit installed');
+if (!fs.existsSync(path.join(repo, '.issflow', 'commands', 'feature.md'))) die('no .issflow/commands/feature.md here — run from a repo with the kit installed');
 if (!process.env.ANTHROPIC_API_KEY) die('ANTHROPIC_API_KEY is not set');
 
 const dockerOk = spawnSync('docker', ['version'], { stdio: 'ignore' });
@@ -44,7 +44,7 @@ const haveImage = spawnSync('docker', ['image', 'inspect', IMAGE], { stdio: 'ign
 if (!haveImage || rebuild) {
   const df = fs.existsSync(path.join(repo, 'Dockerfile.issflow'))
     ? 'Dockerfile.issflow'
-    : path.join('.claude', 'templates', 'automation', 'Dockerfile');
+    : path.join('.issflow', 'templates', 'automation', 'Dockerfile');
   console.log(`feature-docker: building ${IMAGE} from ${df} …`);
   if (run('docker', ['build', '-t', IMAGE, '-f', df, '.']).status !== 0) die('image build failed');
 }

package/template/.issflow/templates/proposal.html

@@ -0,0 +1,204 @@
+<!doctype html>
+<!--
+  Client-facing proposal (rendered by /propose from docs/PROPOSAL.md).
+
+  PAGE 1 = the only signable A4 sheet (packages 3–6 rows, short scope). Trim
+  sign-page copy before it overflows. Screen sheets after the first page-break
+  may grow extra A4 pages.
+
+  HOW TO USE (agent): copy to docs/proposal.html, replace every {{PLACEHOLDER}}.
+  Localise CONTENT to the project language; section labels are bilingual (TH / EN).
+  WHITE-LABEL: fill {{COMPANY}} / {{LOGO}} with the ISSUING company's brand (not
+  the kit's). {{LOGO}} optional: an <img src="…">, an SVG, or delete the monogram.
+  {{BANK_COL}}: omit unless the human gave bank details (no kit default).
+  {{PACKAGE_TABLE}}: default head = ชุดงาน / Packages + Cost; if hours columns
+  were requested = ประเมิน / คิดเงิน / ยอด. Never leave sample amounts in the file.
+  {{SCREEN_SHEETS}}: one .sheet.screens per appendix page; cover every in-scope
+  module from PLAN + OVERVIEW; numbered captions; no emoji icons; not pixel-binding.
+  {{PAGE_FOOTER}}: real page count (sign page 1 of N).
+  Print: Ctrl/Cmd-P → A4 → "Save as PDF".
+
+  Example screen frame (fill {{SCREEN_SHEETS}}; placeholders only — no domain copy):
+  <div class="sheet screens">
+    <div class="head">… {{COMPANY}} · ตัวอย่างจอ — ไม่ผูกพิกเซล / Screens — not pixel-binding</div>
+    <div class="modbar"><span class="here">{{MODULE}}</span></div>
+    <p class="note">{{SCREEN_NOTE}}</p>
+    <div class="figs">
+      <figure>
+        <div class="desk">
+          <div class="top"><span class="mark">{{MARK}}</span><span class="brand">{{APP_NAME}}</span></div>
+          <div class="body">
+            <div class="nav"><span class="on">{{NAV_ON}}</span></div>
+            <div class="main">
+              <div class="kpis"><div class="card">{{CARD}}</div></div>
+              <table class="ui">{{UI_ROWS}}</table>
+            </div>
+          </div>
+        </div>
+        <figcaption><b>{{FRAME_N}}. {{FRAME_TITLE}}</b> — {{FRAME_CAPTION}}</figcaption>
+      </figure>
+      <figure>
+        <div class="phone">
+          <div class="top"><span class="mark">{{MARK}}</span><span class="brand">{{APP_NAME}}</span></div>
+          <div class="screen">{{PHONE_BODY}}</div>
+        </div>
+        <figcaption><b>{{FRAME_N}}. {{FRAME_TITLE}}</b> — {{FRAME_CAPTION}}</figcaption>
+      </figure>
+    </div>
+  </div>
+-->
+<html lang="{{LANG}}">
+<head>
+<meta charset="utf-8" />
+<title>{{TITLE}} — Proposal {{VERSION}}</title>
+<style>
+  @page { size: A4; margin: 0 }
+  :root{
+    --ink:#162033; --muted:#5d6a7d; --line:#dbe3ee; --soft:#f6f8fb;
+    --violet:#635bff; --green:#15803d; --bad:#b42318;
+    --sans:"Inter","Noto Sans Thai",-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;
+    --mono:ui-monospace,Menlo,Consolas,monospace;
+  }
+  *{box-sizing:border-box}
+  body{margin:0;background:#e9edf3;color:var(--ink);font-family:var(--sans);font-size:10.5px;line-height:1.4}
+  .sheet{width:210mm;min-height:297mm;margin:10mm auto;background:#fff;padding:13mm 15mm;display:flex;flex-direction:column;gap:8px}
+  .lbl{color:var(--muted);font-size:8px;font-weight:800;letter-spacing:.06em;text-transform:uppercase;margin:0 0 3px}
+  .lbl em{font-style:normal;opacity:.6;font-weight:600}
+  h1{font-size:19px;margin:0;letter-spacing:-.3px;line-height:1.15}
+  .muted{color:var(--muted)} ul{margin:0;padding-left:15px} li{margin:1px 0}
+
+  .head{display:flex;justify-content:space-between;align-items:flex-start;border-bottom:2px solid var(--ink);padding-bottom:9px}
+  .co{display:flex;align-items:center;gap:10px}
+  .logo{width:40px;height:40px;border-radius:9px;background:var(--ink);color:#fff;display:flex;align-items:center;justify-content:center;font-weight:800;font-size:13px;flex:0 0 auto;overflow:hidden}
+  .logo img{width:100%;height:100%;object-fit:contain}
+  .co .name{font-weight:800;font-size:15px;line-height:1.15}
+  .co .tag{color:var(--muted);font-size:9px}
+  .head .meta{text-align:right;font-size:9px;color:var(--muted)}
+  .head .meta .big{font:800 12px/1.2 var(--sans);letter-spacing:.12em;color:var(--violet)}
+  .pill{display:inline-block;border:1px solid var(--line);border-radius:999px;padding:2px 8px;font:800 8px/1 var(--mono);color:var(--muted);margin-top:4px}
+
+  .cols{display:flex;gap:16px} .cols>div{flex:1;min-width:0}
+  table.quote{width:100%;border-collapse:collapse;font-size:10px}
+  .quote th,.quote td{text-align:left;padding:4px 6px;border-bottom:1px solid var(--line)}
+  .quote th{background:var(--soft);font-size:8px;text-transform:uppercase;letter-spacing:.04em;color:var(--muted)}
+  .quote td.n,.quote th.n{text-align:right;font-family:var(--mono)}
+  .quote tfoot td{font-weight:800;border-top:1.5px solid var(--ink);border-bottom:none}
+  .total{display:flex;align-items:flex-end;justify-content:space-between;background:var(--soft);border-radius:9px;padding:8px 12px;gap:12px}
+  .total .amt{font-size:18px;font-weight:800;text-align:right}
+  .total .amt small{display:block;font-size:9px;color:var(--muted);font-weight:600}
+
+  .sign{display:flex;gap:34px;margin-top:auto;padding-top:10px}
+  .sign>div{flex:1} .line{border-bottom:1px solid var(--ink);height:26px} .sign .lbl{margin-top:4px}
+  footer{border-top:1px solid var(--line);padding-top:7px;color:var(--muted);font-size:8px;display:flex;justify-content:space-between}
+
+  /* screen appendix — empty chrome; fill from PLAN + OVERVIEW */
+  .sheet.screens{padding:10mm 12mm;gap:6px}
+  .screens .head{padding-bottom:6px}
+  .screens .note{font-size:9px;margin:0;color:var(--muted)}
+  .modbar{display:flex;flex-wrap:wrap;gap:4px}
+  .modbar span{border:1px solid var(--line);border-radius:999px;padding:2px 7px;font-size:8px;font-weight:700;color:var(--muted)}
+  .modbar .here{background:#ecebff;border-color:#d4d1ff;color:var(--violet)}
+  .figs{display:grid;grid-template-columns:1fr 1fr;gap:8px 10px;flex:1}
+  figure{margin:0;display:flex;flex-direction:column;min-width:0}
+  figcaption{margin-top:3px;font-size:8px;color:var(--muted);line-height:1.35}
+  figcaption b{color:var(--ink);font-weight:700}
+  .desk,.phone{background:#fff;border:1px solid var(--line);border-radius:10px;overflow:hidden;flex:1;min-height:0}
+  .top{display:flex;align-items:center;gap:6px;padding:5px 8px;border-bottom:1px solid var(--line);background:var(--soft)}
+  .mark{width:16px;height:16px;border-radius:4px;background:var(--violet);color:#fff;font-size:8px;font-weight:800;display:flex;align-items:center;justify-content:center}
+  .brand{font-weight:800;font-size:10px;color:var(--violet)}
+  .sub{font-size:8px;color:var(--muted)}
+  .body{display:flex;min-height:148px}
+  .nav{width:64px;border-right:1px solid var(--line);padding:5px;font-size:8px}
+  .nav span{display:block;padding:2px 4px;border-radius:4px;margin-bottom:1px;color:#334155}
+  .nav .on{background:#ecebff;color:var(--violet);font-weight:700}
+  .nav .tail{margin-top:6px;padding-top:4px;border-top:1px solid var(--line)}
+  .main{flex:1;padding:6px;min-width:0}
+  .kpis{display:grid;grid-template-columns:1fr 1fr 1fr;gap:4px}
+  .kpis.two{grid-template-columns:1fr 1fr}
+  .card{border:1px solid var(--line);border-radius:6px;padding:4px 5px;font-size:8px;background:#fff}
+  .card .n{font-size:12px;font-weight:800}
+  .red{border-color:#f0c4c0;background:#fff7f6}
+  .red .n{color:var(--bad)}
+  .ok{border-color:#b7d4c2;background:#f4faf6}
+  .ok .n{color:var(--green)}
+  .warn{border-color:#ead8a4;background:#fffbeb}
+  .ui{width:100%;border-collapse:collapse;font-size:8px;margin-top:4px}
+  .ui th,.ui td{text-align:left;padding:2px 3px;border-bottom:1px solid var(--line)}
+  .ui th{color:var(--muted);font-weight:600}
+  .btn{display:inline-block;background:var(--violet);color:#fff;border-radius:4px;padding:3px 7px;font-size:8px;font-weight:700;margin-top:5px}
+  .btn.ghost{background:#fff;color:var(--violet);border:1px solid var(--violet)}
+  .field{display:flex;justify-content:space-between;gap:8px;border-bottom:1px dashed var(--line);padding:3px 0;font-size:8px}
+  .crumbs{font-size:8px;color:var(--muted);margin-bottom:3px}
+  .login{padding:12px;min-height:148px;display:flex;flex-direction:column;justify-content:center;align-items:flex-start;gap:6px}
+  .login h3{margin:0;font-size:12px}
+  .phone{max-width:168px;margin:0 auto;width:100%}
+  .screen{padding:7px}
+  .tiny{font-size:7px;color:var(--muted)}
+
+  @media print{
+    body{background:#fff}
+    .sheet{margin:0;min-height:297mm;page-break-after:always;box-shadow:none}
+    .sheet:last-child{page-break-after:auto}
+  }
+</style>
+</head>
+<body>
+<div class="sheet">
+
+  <div class="head">
+    <div class="co">
+      <span class="logo">{{LOGO}}</span>
+      <span><span class="name">{{COMPANY}}</span><br><span class="tag">{{COMPANY_TAGLINE}}</span></span>
+    </div>
+    <div class="meta">
+      <div class="big">PROPOSAL</div>
+      {{VERSION}} · {{DATE}}<br><span class="pill">{{STATUS}}</span>
+    </div>
+  </div>
+
+  <div>
+    <p class="lbl">ใบเสนอราคา <em>Prepared for</em></p>
+    <h1>{{TITLE}}</h1>
+    <p class="muted" style="margin:3px 0 0">{{CLIENT}} — {{SUMMARY}}</p>
+  </div>
+
+  <div class="cols">
+    <div><p class="lbl">ขอบเขตงาน <em>In scope</em></p><ul>{{SCOPE_IN_ITEMS}}</ul></div>
+    <div><p class="lbl">นอกขอบเขต <em>Out of scope</em></p><ul>{{SCOPE_OUT_ITEMS}}</ul></div>
+  </div>
+
+  <div>
+    <p class="lbl">ชุดงาน &amp; ค่าใช้จ่าย <em>Packages &amp; cost</em></p>
+    <table class="quote">{{PACKAGE_TABLE}}</table>
+  </div>
+
+  <div class="total">
+    <span><span class="lbl" style="margin:0">ราคารวม <em>Total</em></span><br><span class="muted" style="font-size:9px">{{TIMELINE}}</span></span>
+    <!-- CLIENT-SAFE: totals only. Never put rate, rate card, or contingency % in {{TOTAL_NOTE}}. Leave empty or a non-rate label (e.g. currency). -->
+    <span class="amt">{{TOTAL_COST}} <small>{{TOTAL_NOTE}}</small></span>
+  </div>
+
+  <div class="cols">
+    <div><p class="lbl">สมมุติฐาน <em>Assumptions</em></p><ul>{{ASSUMPTION_ITEMS}}</ul></div>
+    <div><p class="lbl">ข้อยกเว้น <em>Exclusions</em></p><ul>{{EXCLUSION_ITEMS}}</ul></div>
+  </div>
+
+  <div class="cols">
+    <div>
+      <p class="lbl">เงื่อนไขการชำระเงิน <em>Payment</em></p>
+      <ul>{{PAYMENT_ITEMS}}</ul>
+    </div>
+    {{BANK_COL}}
+  </div>
+
+  <div class="sign">
+    <div><div class="line"></div><p class="lbl">ลงนามลูกค้า <em>Client sign-off</em></p></div>
+    <div><div class="line"></div><p class="lbl">วันที่ <em>Date</em></p></div>
+  </div>
+
+  <footer><span>{{COMPANY}} · {{PAGE_FOOTER}}</span><span>{{VERSION}}</span></footer>
+</div>
+
+{{SCREEN_SHEETS}}
+</body>
+</html>

package/template/.claude/README.md

@@ -1,33 +0,0 @@
-# `.claude/` — portable iStartSoftFlow kit
-
-This directory is the **portable workflow kit** installed into every project.
-Content is **tool-agnostic**. The folder name `.claude/` is a **host convention**
-(Claude Code and several other agents load commands/agents/hooks from this path).
-It is **not** “Claude-only product branding.”
-
-**Human entry points (repo root):**
-
-| File | Role |
-|------|------|
-| `AGENTS.md` | Open-standard primary entry — indexes this kit |
-| `CLAUDE.md` | Thin shim (`@AGENTS.md`) — only because Claude Code auto-loads that filename |
-
-**Single source of truth for rules:** [`istartsoft-flow/METHODOLOGY.md`](./istartsoft-flow/METHODOLOGY.md)
-
-## Layout
-
-| Path | What |
-|------|------|
-| `agents/` | Fresh-context workers (planner, researcher, implementer, …) |
-| `commands/` | Procedures — Default: `/overview` `/feature` `/quick`; Advanced: `/propose` `/design` `/support` … |
-| `skills/` | On-demand cookbooks (ux-design, security, support-triage, …) |
-| `hooks/` | Lifecycle enforcement (context, plan gate, feature gate, …) |
-| `istartsoft-flow/` | METHODOLOGY.md — every hard rule lives here once |
-| `templates/` | Proposal / UX pack / architecture / CR / FEATURE / automation |
-| `settings.json` | Host hook wiring (when using Claude Code adapter) |
-| `flow-config.json` | Context watchdog + sprint knobs (optional overrides) |
-
-Do **not** duplicate METHODOLOGY rules into other files (anti-drift).
-Do **not** put personal rate cards or salary numbers in this kit.
-
-Installer: `npx create-issflow` (omit `--tool` = all adapters).