@jtf19/vibecoding-kit 0.1.0

package/templates/implementation-plan.md

@@ -0,0 +1,73 @@
+---
+artifact_kind: implementation-plan
+version: 1
+source_skill: vibe-writing-plans
+status: draft
+next_skill: vibe-test-driven-development
+---
+
+# Implementation Plan
+
+## Goal
+
+Describe the implementation goal in one or two concrete sentences.
+
+## Architecture Binding
+
+- architecture_artifact: path/to/architecture-design.md
+- architecture_gate: methodology --gate --kind architecture-design
+
+## Artifact Gate Productization
+
+- product_gate: methodology --gate --kind product-spec
+- ui_gate: methodology --gate --kind ui-design
+- architecture_gate: methodology --gate --kind architecture-design
+- traceability_gate: methodology --gate --kind delivery-traceability
+- implementation_gate: methodology --gate --kind implementation-plan
+- completion_gate: completion --evidence-bundle
+- contract: artifact gates are read-only; runtime validates local refs and digest bindings only.
+- not_authorized: command execution, test execution, git write, PR, merge, subagent, platform API.
+
+## Implementation Task Registry
+
+- task_id: task-example
+  required: true
+  status: planned
+  source_refs: req-example, story-example, adr-example
+  expected_files: src/example.js
+  allowed_paths: src/**
+  expected_operations: modify
+  required_scenario_refs: scenario-example
+  test_required: true
+  risk: medium
+  rollback: revert task-example changes only
+
+## Tasks
+
+- id: task-example
+  owner: src/example.js
+  layer: runtime core
+  dependency_direction: command wrapper -> domain core
+  acceptance: expected behavior is observable through deterministic evidence.
+  verification: test evidence envelope binds task_refs and scenario_refs.
+
+## Delivery Traceability
+
+- traceability_artifact: path/to/delivery-traceability.yaml
+- traceability_ref: trace-example
+
+## Evidence
+
+- evidence_sources: user_or_ci_supplied_only
+- not_verified: runtime does not execute tests or read git diff
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- test_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false

package/templates/product-acceptance.md

@@ -0,0 +1,84 @@
+---
+artifact_kind: product-acceptance
+version: 1
+source_skill: vibe-product-acceptance
+status: draft
+next_skill: vibe-verification-before-completion
+---
+
+# Product Acceptance Artifact
+
+## Goal
+
+- product_claim:
+- acceptance_scope:
+- ship_decision: pass | fail | blocked | not_applicable
+
+## Input
+
+- product_spec_artifact:
+- ui_design_contract_artifact:
+- scenario_acceptance_artifact:
+- engineering_evidence:
+
+## Output Fields
+
+- scenario_coverage:
+- user_flow_evidence:
+- ui_state_evidence:
+- accessibility_evidence:
+- metric_readiness:
+- experience_gaps:
+- not_verified:
+- next_skill: vibe-verification-before-completion | vibe-implementation | vibe-planning | vibe-product-spec | none
+
+## Non Goals
+
+- not_in_scope:
+
+## Risks
+
+- experience_risks:
+- release_risks:
+- unresolved_decisions:
+
+## Acceptance
+
+- pass_conditions:
+- fail_conditions:
+- blocked_conditions:
+
+## Reference Registry
+
+reference_registry:
+  product_acceptance_refs:
+    - acceptance-example
+
+## Evidence
+
+- evidence_sources:
+- not_verified:
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-product-acceptance
+next_skill: vibe-verification-before-completion
+reason:
+handoff:
+  goal:
+  scope:
+  key_decisions:
+  files:
+  risks:
+  acceptance:
+stop_condition: none

package/templates/product-discovery.md

@@ -0,0 +1,81 @@
+---
+artifact_kind: product-discovery
+version: 1
+source_skill: vibe-product-discovery
+status: draft
+next_skill: vibe-product-spec
+---
+
+# Product Discovery Artifact
+
+## Goal
+
+- problem:
+- target_users:
+- value_hypothesis:
+- mvp_slice:
+
+## Input
+
+- original_request:
+- context:
+- constraints:
+
+## Output Fields
+
+- scenarios:
+- current_alternatives:
+- success_metrics:
+- anti_metrics:
+- decision: continue | pause | needs_more_info
+- next_skill: vibe-product-spec | vibe-planning | vibe-brainstorming | none
+
+## Non Goals
+
+- not_in_scope:
+
+## Risks
+
+- product_risks:
+- assumptions:
+- open_questions:
+
+## Acceptance
+
+- discovery_complete_when:
+- blocked_when:
+
+## Reference Registry
+
+reference_registry:
+  requirement_refs:
+    - req-example
+
+## Evidence
+
+- evidence_sources:
+- not_verified:
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-product-discovery
+next_skill: vibe-product-spec
+reason:
+handoff:
+  goal:
+  scope:
+  key_decisions:
+  files:
+  risks:
+  acceptance:
+stop_condition: none

package/templates/product-spec.md

@@ -0,0 +1,84 @@
+---
+artifact_kind: product-spec
+version: 1
+source_skill: vibe-product-spec
+status: draft
+next_skill: vibe-ui-design
+---
+
+# Product Spec Artifact
+
+## Goal
+
+- product_goal:
+- release_slice:
+- priority:
+
+## Input
+
+- discovery_artifact:
+- users_and_scenarios:
+- constraints:
+
+## Output Fields
+
+- user_stories:
+- functional_requirements:
+- non_functional_requirements:
+- acceptance_criteria:
+- out_of_scope:
+- open_questions:
+- next_skill: vibe-ui-design | vibe-planning | vibe-product-discovery | none
+
+## Non Goals
+
+- out_of_scope:
+
+## Risks
+
+- product_risks:
+- delivery_risks:
+- unresolved_decisions:
+
+## Acceptance
+
+- acceptance_criteria:
+- fail_conditions:
+- release_readiness_signal:
+
+## Reference Registry
+
+reference_registry:
+  requirement_refs:
+    - req-example
+  product_story_refs:
+    - story-example
+
+## Evidence
+
+- evidence_sources:
+- not_verified:
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-product-spec
+next_skill: vibe-ui-design
+reason:
+handoff:
+  goal:
+  scope:
+  key_decisions:
+  files:
+  risks:
+  acceptance:
+stop_condition: none

package/templates/scenario-acceptance.yaml

@@ -0,0 +1,37 @@
+version: 1
+artifact_kind: scenario-acceptance
+source_skill: vibe-product-acceptance
+status: draft
+next_skill: vibe-product-acceptance
+
+# Boundary
+boundary:
+  writes: false
+  state_directory_created: false
+  command_execution: false
+  skill_execution: false
+  subagent: false
+  mcp: false
+  git: false
+# Reference Registry
+# scenarios[].id is the source of delivery-traceability scenario_ref and test evidence scenario_refs.
+scenarios:
+  - id: create-project-happy-path
+    user: target user or role
+    given:
+      - precondition
+    when:
+      - user action
+    then:
+      - expected user-visible result
+    ui_states:
+      - loading
+      - success
+    # Evidence
+    evidence:
+      required:
+        - manual_observation
+        - test_output
+      optional:
+        - screenshot
+    status: not_verified

package/templates/ui-design-contract.md

@@ -0,0 +1,86 @@
+---
+artifact_kind: ui-design-contract
+version: 1
+source_skill: vibe-ui-design
+status: draft
+next_skill: vibe-planning
+---
+
+# UI Design Contract Artifact
+
+## Goal
+
+- design_goal:
+- primary_user_flow:
+- target_surfaces:
+
+## Input
+
+- product_spec_artifact:
+- user_stories:
+- design_constraints:
+
+## Output Fields
+
+- screens:
+- user_flow:
+- information_architecture:
+- components:
+- ui_states:
+- copy_rules:
+- interaction_rules:
+- responsive_rules:
+- accessibility:
+- design_acceptance:
+- next_skill: vibe-planning | vibe-product-spec | none
+
+## Non Goals
+
+- not_in_scope:
+
+## Risks
+
+- usability_risks:
+- accessibility_risks:
+- open_questions:
+
+## Acceptance
+
+- design_acceptance:
+- ui_state_acceptance:
+- accessibility_acceptance:
+
+## Reference Registry
+
+reference_registry:
+  ui_flow_refs:
+    - flow-example
+
+## Evidence
+
+- evidence_sources:
+- not_verified:
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-ui-design
+next_skill: vibe-planning
+reason:
+handoff:
+  goal:
+  scope:
+  key_decisions:
+  files:
+  risks:
+  acceptance:
+stop_condition: none

package/tools/vibe-architecture-check/README.md

@@ -0,0 +1,66 @@
+# Vibecoding Architecture Check
+
+`vibe-architecture-check` 是全项目只读架构信号收集器。
+
+它不是功能测试，也不是 hard gate。它用于提醒 agent 在写源码前进行架构判断：代码膨胀只是症状，真正要检查的是职责归属、依赖方向、数据流、状态生命周期、契约同步、风险等级和演进成本。
+
+## Usage
+
+```bash
+node tools/vibe-architecture-check/index.mjs --root .
+node tools/vibe-architecture-check/index.mjs --root . --json
+```
+
+## 配置
+
+项目级边界配置位于根目录：
+
+```bash
+architecture.boundaries.json
+```
+
+该配置声明：
+
+- `layers`：项目层级和角色命名。
+- `roleBudgets`：不同角色文件的体积、函数数量和长函数预算。
+- `forbiddenDependencies`：禁止的反向依赖或跨层依赖。
+- `riskZones` / `highRiskTerms`：高风险执行链路、状态链路和持久化关键词。
+- `contractSurfaces` / `contractSyncHints`：CLI、JSON envelope、artifact、README、template、doctor、runtime-check、release-check 等契约面。
+- `roleOverrides`：按路径 glob 覆盖默认角色分类，例如把 CI evidence producer 示例归为 `smoke`，把 full-chain 静态示例归为 `docs`。
+- `baselinedWarnings`：已确认的历史架构债基线，按路径和规则过滤；它是 `docs/architecture-debt-burndown.md` 的燃尽入口，不是永久豁免。新增路径或新增规则仍会继续报告，`baselined_warning_count` 增长必须有 owner、风险和退出条件。
+
+## 规则族
+
+- `file-role-budget`：文件是否超过当前角色的体积预算。
+- `function-density`：单文件函数数量是否过高。
+- `long-function`：函数是否继续膨胀。
+- `entry-like-domain-logic`：entry、dispatcher、check runner 是否承载明显 domain logic。
+- `owner-drift`：一个文件是否混入过多 domain 信号。
+- `dependency-direction`：core/state/command wrapper 是否出现反向依赖或跨层依赖。
+- `state-boundary`：状态目录、状态写入、状态校验、artifact/envelope 等生命周期信号是否出现在可疑 owner。
+- `contract-sync`：命令、参数、验证、JSON envelope 或 artifact 变化是否提示同步 README、template、doctor、runtime-check、release-check。
+- `factory-pressure`：`createX(deps)` 工厂依赖面是否膨胀。
+- `io-purity`：core 文件是否混入 `process`、`console`、文件写入或子进程等 IO/展示边界。
+- `risk-zone-touch`：execution、scheduler、daemon、source apply、merge、retry、queue、lease、persistent state 等高风险链路信号。
+- `evolution-pressure`：TODO/FIXME/HACK 或 generic helper/shared 命名是否提示长期演进成本。
+- `diff-aware-growth`：当前 diff 是否让单文件净增长过多。
+
+## 使用语义
+
+- warning 表示“需要架构判断”，不表示代码一定错误。
+- `baselinedWarnings` 表示“已登记、待燃尽的历史债务”，不表示“以后可以忽略”。
+- release gate 只验证工具稳定和 JSON schema，不因历史架构债失败。
+- 高风险状态链路需要明确计划、更小变更面和更强验证证据。
+- 如果规则误报，优先调整 `architecture.boundaries.json`，不要把项目细节硬塞进工具代码。
+
+## 边界
+
+- 只读。
+- 不写源码。
+- 不创建状态目录。
+- 不调用网络、模型、subagent、MCP。
+- warning 不阻断 release gate。
+
+## 设计意图
+
+该工具把 `tools/vibe-runtime/index.mjs` 的膨胀教训推广成全项目协议：写代码前先判断 owner、layer、dependency direction、data flow、state lifecycle、contract sync、blast radius、evolution path、complexity containment 和 risk class。