intentdna 1.0.0

package/dist/templates/pr-submitter.dna.yaml

@@ -0,0 +1,55 @@
+# pr-submitter: PR 提交前清单
+# 参考 Superpowers: requesting-code-review skill
+# 适用: 提交 PR 前的自检流程
+
+version: "0.1.0"
+id: template_pr_submitter
+name: PR Submitter Checklist
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  pre_review_checklist:
+    description: Complete checklist before requesting review
+    codons:
+      - type: attract
+        target: self_review_first
+      - type: attract
+        target: tests_passing
+      - type: attract
+        target: documentation_updated
+      - type: repel
+        target: submit_without_self_review
+      - type: threshold
+        condition: "pr_without_tests == false"
+        action: block
+
+  clear_description:
+    description: PR must have clear description of what and why
+    codons:
+      - type: attract
+        target: change_summary
+      - type: attract
+        target: test_plan
+      - type: repel
+        target: empty_pr_description
+      - type: sense
+        signal: ambiguous_requirement
+        response: escalate_to_human
+
+  small_diffs:
+    description: Keep PRs focused and reviewable
+    codons:
+      - type: attract
+        target: single_concern_pr
+      - type: repel
+        target: mixed_concerns
+      - type: weight
+        a: granularity
+        b: speed
+        ratio: 0.7
+
+contexts: {}

package/dist/templates/safe-refactoring.dna.yaml

@@ -0,0 +1,65 @@
+# safe-refactoring: 安全重构
+# 参考 Superpowers: test-driven-development (refactor phase of RED-GREEN-REFACTOR)
+# 参考 Superpowers: verification-before-completion
+# 适用: 大规模重构需要步步为营
+
+version: "0.1.0"
+id: template_safe_refactoring
+name: Safe Refactoring
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  test_coverage_first:
+    description: Ensure existing behavior is tested before refactoring
+    codons:
+      - type: attract
+        target: characterization_tests
+      - type: attract
+        target: existing_test_green
+      - type: repel
+        target: refactor_without_tests
+      - type: threshold
+        condition: "refactor_untested_code == false"
+        action: escalate
+
+  small_steps:
+    description: Refactor in small, verifiable steps
+    codons:
+      - type: attract
+        target: incremental_changes
+      - type: attract
+        target: run_tests_between_steps
+      - type: repel
+        target: big_bang_refactor
+      - type: weight
+        a: safety
+        b: speed
+        ratio: 0.8
+
+  behavior_preservation:
+    description: Refactoring must not change external behavior
+    codons:
+      - type: attract
+        target: same_inputs_same_outputs
+      - type: repel
+        target: sneaky_behavior_changes
+      - type: threshold
+        condition: "test_regression == false"
+        action: block
+      - type: sense
+        signal: uncertain_information
+        response: verify_before_share
+
+  no_mixed_commits:
+    description: Separate refactoring commits from feature commits
+    codons:
+      - type: attract
+        target: pure_refactoring_commits
+      - type: repel
+        target: mixed_refactor_and_feature
+
+contexts: {}

package/dist/templates/secure-dev.dna.yaml

@@ -0,0 +1,90 @@
+# secure-dev: 安全开发基线
+# 参考 Superpowers: TDD, code-review, systematic-debugging
+# 适用: 任何开发团队的安全 + 质量基线
+
+version: "0.1.0"
+id: template_secure_dev
+name: Secure Development Baseline
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  code_quality:
+    description: Enforce code quality standards
+    codons:
+      - type: attract
+        target: tested_code
+      - type: attract
+        target: type_safety
+      - type: repel
+        target: untested_changes
+      - type: threshold
+        condition: "test_coverage >= 80%"
+        action: warn
+
+  security:
+    description: Security-first development
+    codons:
+      - type: repel
+        target: hardcoded_secrets
+      - type: repel
+        target: sql_injection
+      - type: repel
+        target: xss_vulnerabilities
+      - type: threshold
+        condition: "personal_data_exposure == false"
+        action: block
+      - type: threshold
+        condition: "production_delete == false"
+        action: block
+
+  safe_operations:
+    description: Prevent destructive operations
+    codons:
+      - type: repel
+        target: force_push
+      - type: repel
+        target: drop_database
+      - type: threshold
+        condition: "irreversible_action_without_confirmation == false"
+        action: escalate
+
+roles:
+  reviewer:
+    description: Code reviewer — read only, outputs review report
+    tool_permissions:
+      allow: [Read, Grep, Glob, Bash]
+      deny: [Edit, Write, NotebookEdit]
+    scope:
+      read: ["**/*"]
+      write: []
+    instructions:
+      - Review code for correctness, security, and style
+      - Never modify source code — you are read-only
+      - Output a clear verdict (PASS or FAIL) with specific line references
+
+  implementer:
+    description: Feature implementer — writes code within scope
+    tool_permissions:
+      allow: [Read, Edit, Write, Grep, Glob, Bash]
+    scope:
+      read: ["**/*"]
+      write: ["src/**", "test/**"]
+    instructions:
+      - Write tests before or alongside implementation
+      - Run tests after every change
+      - Stay within the defined scope — do not modify CI/CD or config files
+
+contexts:
+  hotfix:
+    description: Emergency production fix
+    modifiers:
+      - gene: safe_operations
+        action: suppress
+        factor: 0.5
+      - gene: code_quality
+        action: amplify
+        factor: 1.5

package/dist/templates/subagent-parallel.dna.yaml

@@ -0,0 +1,98 @@
+# subagent-parallel: 多 Agent 并行 + 两阶段审查
+# 参考 Superpowers: subagent-driven-development + dispatching-parallel-agents
+# 参考 Cline KanBan: worktree isolation + dependency chain
+# 适用: 大型任务需要并行拆分执行
+
+version: "0.1.0"
+id: template_subagent_parallel
+name: Subagent Parallel Development
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  task_isolation:
+    description: Each subtask runs in isolated context
+    codons:
+      - type: attract
+        target: isolated_execution
+      - type: attract
+        target: worktree_per_task
+      - type: repel
+        target: shared_state_mutation
+      - type: threshold
+        condition: "cross_task_file_conflict == false"
+        action: block
+
+  two_phase_review:
+    description: Every subtask reviewed for spec compliance then code quality
+    codons:
+      - type: attract
+        target: spec_compliance_check
+      - type: attract
+        target: code_quality_check
+      - type: threshold
+        condition: "merge_without_review == false"
+        action: block
+
+  parallel_safety:
+    description: Limit concurrent agents and cost
+    codons:
+      - type: threshold
+        condition: "concurrent_agents <= 5"
+        action: escalate
+      - type: threshold
+        condition: "daily_spend <= 100"
+        action: warn
+      - type: weight
+        a: parallelism
+        b: cost
+        ratio: 0.6
+
+contexts: {}
+
+roles:
+  architect:
+    description: Decomposes tasks and reviews results
+    tool_permissions:
+      allow: [Read, Grep, Glob, Bash]
+      deny: [Edit, Write, NotebookEdit]
+    scope:
+      read: ["**/*"]
+      write: []
+    instructions:
+      - Break the task into independent subtasks that can run in parallel
+      - Define clear inputs and outputs for each subtask
+      - Review each subtask result for spec compliance first, then code quality
+      - Reject and re-dispatch any subtask that fails review
+
+  worker:
+    description: Executes a single subtask in isolation
+    tool_permissions:
+      allow: [Read, Edit, Write, Grep, Glob, Bash]
+    scope:
+      read: ["**/*"]
+      write: ["src/**", "test/**"]
+    instructions:
+      - Execute only the assigned subtask, nothing more
+      - Write tests for your changes
+      - Do not modify files outside your assigned scope
+      - Report completion with a summary of changes
+
+workflows:
+  parallel-dev:
+    name: Parallel Development
+    steps:
+      - id: plan
+        role: architect
+        description: Decompose task into parallel subtasks
+      - id: execute
+        role: worker
+        depends_on: [plan]
+        description: Execute assigned subtask
+      - id: review
+        role: architect
+        depends_on: [execute]
+        description: Two-phase review (spec + quality)

package/dist/templates/systematic-debugging.dna.yaml

@@ -0,0 +1,55 @@
+# systematic-debugging: 系统化调试流程
+# 参考 Superpowers: systematic-debugging skill
+# 适用: 需要结构化调试纪律的团队
+
+version: "0.1.0"
+id: template_systematic_debugging
+name: Systematic Debugging
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  debug_discipline:
+    description: Follow systematic debugging process
+    codons:
+      - type: attract
+        target: reproduce_first
+      - type: attract
+        target: read_error_messages
+      - type: attract
+        target: check_recent_changes
+      - type: repel
+        target: random_changes
+      - type: repel
+        target: shotgun_debugging
+      - type: threshold
+        condition: "fix_without_understanding == false"
+        action: warn
+
+  root_cause:
+    description: Find root cause before fixing
+    codons:
+      - type: attract
+        target: bisect_the_problem
+      - type: attract
+        target: minimal_reproduction
+      - type: repel
+        target: symptom_treatment
+      - type: weight
+        a: thoroughness
+        b: speed
+        ratio: 0.7
+
+  regression_prevention:
+    description: Prevent the same bug from recurring
+    codons:
+      - type: attract
+        target: regression_test
+      - type: threshold
+        condition: "bugfix_without_test == false"
+        action: block
+
+contexts: {}

package/dist/templates/tdd-strict.dna.yaml

@@ -0,0 +1,69 @@
+# tdd-strict: 严格测试驱动开发
+# 参考 Superpowers: test-driven-development skill
+# 适用: 需要严格 TDD 纪律的团队
+
+version: "0.1.0"
+id: template_tdd_strict
+name: Strict Test-Driven Development
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  test_first:
+    description: Tests must be written before implementation
+    codons:
+      - type: attract
+        target: test_before_code
+      - type: attract
+        target: red_green_refactor
+      - type: repel
+        target: implementation_without_tests
+      - type: threshold
+        condition: "untested_code == false"
+        action: block
+
+  test_quality:
+    description: Tests must be meaningful
+    codons:
+      - type: attract
+        target: behavior_verification
+      - type: attract
+        target: edge_case_coverage
+      - type: repel
+        target: trivial_assertions
+      - type: weight
+        a: coverage
+        b: speed
+        ratio: 0.8
+
+  continuous_verification:
+    description: Run tests after every change
+    codons:
+      - type: attract
+        target: run_tests_after_edit
+      - type: threshold
+        condition: "commit_without_green_tests == false"
+        action: block
+
+contexts: {}
+
+roles:
+  implementer:
+    description: TDD implementer — writes tests first, then code
+    tool_permissions:
+      allow: [Read, Edit, Write, Grep, Glob, Bash]
+    scope:
+      read: ["**/*"]
+      write: ["src/**", "test/**"]
+    instructions:
+      - Always write the failing test FIRST
+      - Run the test to confirm it fails (red)
+      - Write the minimum code to make it pass (green)
+      - Refactor if needed, keeping tests green
+      - Never commit with failing tests
+    post_checks:
+      - vitest_run
+      - tsc_no_errors

package/dist/templates/verification-loop.dna.yaml

@@ -0,0 +1,53 @@
+# verification-loop: 完成前确认修复
+# 参考 Superpowers: verification-before-completion skill
+# 参考 systematic-debugging: "confirm the fix actually works"
+# 适用: 任何 bug 修复或功能完成前需要验证的场景
+
+version: "0.1.0"
+id: template_verification_loop
+name: Verification Before Completion
+type: project
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  verify_before_done:
+    description: Never mark a task done without verifying the fix
+    codons:
+      - type: attract
+        target: verification_step
+      - type: attract
+        target: regression_check
+      - type: repel
+        target: assumed_fix
+      - type: threshold
+        condition: "completion_without_verification == false"
+        action: block
+
+  evidence_based:
+    description: Provide evidence that the fix works
+    codons:
+      - type: attract
+        target: test_output_evidence
+      - type: attract
+        target: before_after_comparison
+      - type: repel
+        target: claims_without_proof
+      - type: sense
+        signal: incomplete_result
+        response: retry_with_more_depth
+
+  no_partial_fixes:
+    description: Fix completely or escalate, never ship half-fixes
+    codons:
+      - type: repel
+        target: partial_fix
+      - type: repel
+        target: workaround_without_root_cause
+      - type: sense
+        signal: uncertain_information
+        response: escalate_to_human
+
+contexts: {}

package/dist/templates/yolo-with-guardrails.dna.yaml

@@ -0,0 +1,56 @@
+# yolo-with-guardrails: YOLO 模式 + 安全护栏
+# 参考: YOLO mode 趋势 + Carnegie Mellon 研究
+# 适用: 个人开发者想要全自主但不想翻车
+
+version: "0.1.0"
+id: template_yolo_guardrails
+name: YOLO with Guardrails
+type: personal
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+genes:
+  autonomy:
+    description: Maximum autonomy within safety boundaries
+    codons:
+      - type: attract
+        target: autonomous_execution
+      - type: attract
+        target: minimal_interruption
+      - type: weight
+        a: autonomy
+        b: safety
+        ratio: 0.7
+
+  safety_net:
+    description: Hard limits even in YOLO mode
+    codons:
+      - type: threshold
+        condition: "production_delete == false"
+        action: block
+      - type: threshold
+        condition: "env_file_delete == false"
+        action: block
+      - type: threshold
+        condition: "force_push_main == false"
+        action: block
+      - type: threshold
+        condition: "files_deleted_per_session <= 10"
+        action: escalate
+      - type: threshold
+        condition: "git_reset_hard == false"
+        action: escalate
+
+  cost_control:
+    description: Prevent runaway API costs
+    codons:
+      - type: threshold
+        condition: "daily_spend <= 50"
+        action: warn
+      - type: threshold
+        condition: "daily_spend <= 200"
+        action: block
+
+contexts: {}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "intentdna",
+  "version": "1.0.0",
+  "description": "Intent DNA — Declarative policy layer for AI agent behavior",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "dna": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc && mkdir -p dist/species dist/templates && cp src/species/*.json dist/species/ && cp src/templates/*.yaml dist/templates/",
+    "dev": "tsc --watch",
+    "test": "node --experimental-vm-modules node_modules/.bin/vitest run",
+    "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest"
+  },
+  "author": "Samuel",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lushan1314/intentdna.git"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "guardrails",
+    "policy",
+    "claude",
+    "cursor",
+    "dna",
+    "harness"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}