name: specrail
version: 0.2.1
description: Issue-first, spec-first, AI-assisted repository workflow pack.
durable_state:
provider: github
objects:
- issues
- labels
- pull_requests
- comments
- reviews
- branches
automation_policy:
default_mode: dry_run
allowed_agent_actions:
- propose_labels
- draft_specs
- draft_tasks
- implement_code
- review_pull_request
- diagnose_ci
- draft_release_notes
forbidden_agent_actions:
- final_approval
- merge
- force_push
- close_disputed_issue
- public_security_disclosure
- permission_change
required_human_gates:
- readiness_label
- spec_approval
- final_pr_review
- security_decision
- merge
- release
enforcement:
sensitive_registry:
paths:
- src/rules/compiler.rs
- src/rules/compiler/*
- checks/*
- scripts/sync-specrail-checks.sh
- scripts/ci/specrail_sync_lock.py
- scripts/ci/check_pr_tier.py
- scripts/ci/closure_follow_up.py
- scripts/ci/extract_nonclosing_issue.py
- scripts/ci/test_closure_follow_up.py
- scripts/ci/test_extract_nonclosing_issue.py
- scripts/ci/run_sensitive_implement_gate.py
- scripts/ci/test_run_sensitive_implement_gate.py
- schemas/closure_audit_result.schema.json
- schemas/sensitive_implement_gate_result.schema.json
- schemas/review_result.schema.json
- schemas/pr_review_gate.schema.json
- schemas/duplicate_work_evidence.schema.json
- schemas/runtime_checkpoint.schema.json
- .github/pull_request_template.md
- CONTRIBUTING.md
- .github/workflows/*
- workflow.yaml
specs:
- specs/GH813/*
- docs/specs/preference-rule-compilation/*
artifacts:
spec_packet: specs/GH{issue_number}/
product_spec: specs/GH{issue_number}/product.md
tech_spec: specs/GH{issue_number}/tech.md
task_plan: specs/GH{issue_number}/tasks.md
impl_branch: "{agent}/gh{issue_number}-{slug}"
agent_review: artifacts/review/pr-{pr_number}.json
triage_result: artifacts/triage/issue-{issue_number}.json
action_policy:
actions:
triage_issue:
allowed_from:
- new_issue
- needs_info
- triaged
required_artifacts: []
creates_artifacts:
- triage_result
human_gates: []
write_spec:
allowed_from:
- triaged
- ready_to_spec
required_artifacts:
- linked_issue
creates_artifacts:
- product_spec
- tech_spec
human_gates:
- readiness_label
implement:
allowed_from:
- ready_to_implement
required_artifacts:
- linked_issue
- product_spec
- tech_spec
creates_artifacts:
- task_plan
human_gates:
- readiness_label
- spec_approval
review_pr:
allowed_from:
- impl_pr_open
- agent_review
- human_review
required_artifacts:
- linked_issue
- linked_pr
- verification
creates_artifacts:
- agent_review
human_gates:
- final_pr_review
fix_ci:
allowed_from:
- human_review
- ci_green
required_artifacts:
- linked_pr
creates_artifacts:
- verification
human_gates: []
draft_release_note:
allowed_from:
- merged
required_artifacts:
- linked_pr
creates_artifacts: []
human_gates:
- release
presentation:
default_locale: en-US
supported_locales:
- en-US
- zh-CN
fallback_locale: en-US