yam-flow 0.1.0

package/templates/ueye-review.md

@@ -0,0 +1,110 @@
+# yam Ueye Review
+
+## Input
+
+- Screenshot/URL:
+- Product or screen:
+- Reference direction:
+- Source evidence:
+
+## Direction Fit
+
+- Fits project direction:
+- Mismatch:
+
+## Visual Evidence Inventory
+
+- Evidence bound: 1-3 primary images, max 5 inventory rows by default.
+- Label:
+- Type:
+- Path/URL:
+- Dimensions:
+- sha256:
+- Viewport:
+- State:
+- Role: proof / reference direction / annotation / partial evidence
+- Visual verification cap:
+
+## Reference Read Proof
+
+- Layout:
+- Visual hierarchy:
+- Typography:
+- Color/contrast:
+- Component detail:
+- Interaction/motion:
+- Responsiveness:
+- Brand/mood fit:
+
+## Reference vs Implementation Matrix
+
+| Dimension | Status | Evidence |
+| --- | --- | --- |
+| Layout and spacing | not-verified |  |
+| Visual hierarchy | not-verified |  |
+| Typography | not-verified |  |
+| Color and contrast | not-verified |  |
+| Component detail | not-verified |  |
+| Interaction and motion | not-verified |  |
+| Responsiveness | not-verified |  |
+| Accessibility visuals | not-verified |  |
+| Brand and mood fit | not-verified |  |
+
+Status values: matched / similar / different / not-verified / not-applicable.
+
+## Design Quality Review
+
+| Dimension | Result | Evidence |
+| --- | --- | --- |
+| Visual hierarchy | needs-polish |  |
+| Layout/spacing | needs-polish |  |
+| Typography | needs-polish |  |
+| Color/contrast | needs-polish |  |
+| Component detail | needs-polish |  |
+| Interaction/motion | needs-polish |  |
+| Responsiveness | needs-polish |  |
+| Accessibility | needs-polish |  |
+| Brand/mood fit | needs-polish |  |
+
+Result values: pass / needs-polish / fails.
+
+## P0-P3 Issues
+
+### P0 Blockers
+
+- None.
+
+### P1 Major
+
+- None.
+
+### P2 Quality
+
+- None.
+
+### P3 Polish
+
+- None.
+
+## Checks
+
+- Visual hierarchy:
+- Layout/spacing:
+- Typography:
+- Color/contrast:
+- Component detail:
+- Interaction/motion:
+- Responsiveness:
+- Accessibility:
+- Brand/mood fit:
+- Empty/loading/error/disabled/hover/focus states:
+
+## Safe Fix Path
+
+1.
+2.
+3.
+
+## Truth Status
+
+- verified / partial / skipped / blocked / assumed:

package/templates/yam.project.md

@@ -0,0 +1,73 @@
+# yam Project Pack
+
+## Product Direction
+
+- What this product is:
+- Primary user:
+- Primary workflow:
+- What should feel fast/easy:
+
+## UI Direction
+
+- Visual tone:
+- Existing design system or tokens:
+- Components to follow:
+- Things to avoid:
+
+## Tech Stack
+
+- Framework:
+- Language:
+- Styling:
+- State/data:
+- Auth/payment/DB:
+
+## Commands
+
+- Dev:
+- Typecheck:
+- Lint:
+- Test:
+- Build:
+
+## Key Paths
+
+- App/routes:
+- Components:
+- Styles:
+- Tests:
+- Config:
+
+## Verification Policy
+
+- Tiny changes:
+- UI changes:
+- Feature changes:
+- Risky changes:
+- Public/release changes: scan for external harness/tool names, comparison wording, and origin-credit wording; remove those hits unless the user explicitly approves keeping them.
+
+## Known Risks
+
+- Auth/payment/DB/security:
+- Fragile areas:
+- Slow commands:
+
+## Recent Decisions
+
+- Decision:
+- Reason:
+- Date:
+
+## No-Go Rules
+
+- Do not:
+- Avoid:
+- Do not leave external harness/tool/project comparison, attribution, or origin-credit language in public-facing source, docs, npm metadata, release notes, or GitHub repository text.
+
+## MD Management
+
+- Owner: user-maintained project pack
+- Target size: 500-1200 words
+- Update rule: narrow edits only; do not rewrite the whole pack
+- Generated sections: keep clearly marked
+- Competing instruction files:

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "strict": false,
+    "noImplicitAny": false,
+    "strictNullChecks": false,
+    "noUncheckedIndexedAccess": false,
+    "exactOptionalPropertyTypes": false,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "useUnknownInCatchVariables": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "sourceMap": false,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src/**/*.ts"
+  ]
+}

package/yam.manifest.json

@@ -0,0 +1,48 @@
+{
+  "name": "yam",
+  "version": "0.1.0",
+  "principles": [
+    "Direction before execution.",
+    "Start fast.",
+    "Deepen deliberately.",
+    "Basic direction fit and honest verification always.",
+    "Honest by design.",
+    "Heavy proof when risk or user intent calls for it.",
+    "Token-aware by default.",
+    "Context-reuse first.",
+    "End with remaining tasks and fix-first items."
+  ],
+  "defaultHooks": false,
+  "routes": [
+    {
+      "id": "quick",
+      "stage": "v0.3",
+      "purpose": "Fast scoped implementation, small fixes, and quick error scans with focused verification."
+    },
+    {
+      "id": "ueye",
+      "stage": "v0.3",
+      "purpose": "Tight UI/UX/design implementation and visual review with reference-read proof, visual comparison, design quality review, and P0-P3 issue tracking."
+    },
+    {
+      "id": "question",
+      "stage": "v0.1",
+      "purpose": "Very-light direct Q&A for stable or local questions without implementation."
+    },
+    {
+      "id": "scout",
+      "stage": "v0.1",
+      "purpose": "Lightweight investigation and recommendation without code changes by default."
+    },
+    {
+      "id": "deep",
+      "stage": "v0",
+      "purpose": "Single-agent heavy verification by explicit request, including runtime/tmux/browser/process proof when needed."
+    },
+    {
+      "id": "mission",
+      "stage": "v0.2",
+      "purpose": "Explicit real-subagent/team execution route for approved plans, cross-verification, doctor scan, and final proof."
+    }
+  ]
+}