feat: 根目录文档、脚本、gitignore
This commit is contained in:
@@ -0,0 +1,16 @@
|
||||
# Gate Recommendation Matrix (tgassist)
|
||||
|
||||
> System recommends gates based on project scale and risk level. User confirmation is required.
|
||||
|
||||
## Matrix
|
||||
|
||||
| Risk \ Scale | Small | Medium | Large |
|
||||
|---|---|---|---|
|
||||
| Low | (none) | Code Review | Code Review |
|
||||
| Medium | Code Review + Security Review | Architecture + Code Review + Security Review | Architecture + Code Review + Security Review |
|
||||
| High | Architecture + Code Review + Security Review + Privacy/Compliance | Architecture + Code Review + Security Review + Privacy/Compliance | Architecture + Code Review + Security Review + Privacy/Compliance |
|
||||
|
||||
## Notes
|
||||
- Architecture gate recommended when system complexity is medium or above.
|
||||
- Privacy/Compliance gate recommended for high-risk or personal data handling projects.
|
||||
- User can override recommendations, but must record decision and risk acceptance.
|
||||
@@ -0,0 +1,50 @@
|
||||
# project.yaml Schema (tgassist)
|
||||
|
||||
## Fields
|
||||
|
||||
- `schema.name`:
|
||||
- Value: `tgassist.project`
|
||||
|
||||
- `schema.version`:
|
||||
- Value: `0.1`
|
||||
|
||||
- `project.name`:
|
||||
- Human-readable project name
|
||||
|
||||
- `project.alias`:
|
||||
- Short slug used for directory naming
|
||||
|
||||
- `project.description`:
|
||||
- One-line description
|
||||
|
||||
- `project.owner`:
|
||||
- Primary owner (role/person)
|
||||
|
||||
- `project.created_at`:
|
||||
- ISO date (YYYY-MM-DD)
|
||||
|
||||
- `governance.scale`:
|
||||
- Enum: `small | medium | large`
|
||||
|
||||
- `governance.risk_level`:
|
||||
- Enum: `low | medium | high`
|
||||
|
||||
- `governance.optional_gates`:
|
||||
- `architecture_design`: `enabled | disabled`
|
||||
- `code_review`: `enabled | disabled`
|
||||
- `security_review`: `enabled | disabled`
|
||||
- `privacy_compliance`: `enabled | disabled`
|
||||
|
||||
- `governance.git_policy`:
|
||||
- `enabled`: `true | false`
|
||||
- `commit_format`: string, default `[role][phase] summary - reason`
|
||||
|
||||
- `evidence_sources`:
|
||||
- `codemap`: path string
|
||||
- `domainmap`: path string
|
||||
- `runtime`: path string
|
||||
|
||||
## Notes
|
||||
- Optional gates default to `disabled` until user confirms.
|
||||
- Risk level drives recommended optional gates.
|
||||
- If `git_policy.enabled=true`, commits must include summary, role, phase, and change reason.
|
||||
@@ -0,0 +1,44 @@
|
||||
# session.yaml Schema (tgassist)
|
||||
|
||||
## Fields
|
||||
|
||||
- `schema.name`:
|
||||
- Value: `tgassist.session`
|
||||
|
||||
- `schema.version`:
|
||||
- Value: `0.1`
|
||||
|
||||
- `status.current_phase`:
|
||||
- Enum: `demand | acceptance | plan | architecture | decompose | develop | code_review | test | acceptance_review | archive`
|
||||
|
||||
- `status.current_round`:
|
||||
- Integer (>= 1)
|
||||
|
||||
- `status.state`:
|
||||
- Enum: `in_progress | awaiting_answers | finalized`
|
||||
|
||||
- `status.last_updated`:
|
||||
- ISO date (YYYY-MM-DD)
|
||||
|
||||
- `phases`:
|
||||
- List of phase objects
|
||||
- Each phase has:
|
||||
- `name` (same enum as `current_phase`)
|
||||
- `status`: `pending | in_progress | completed | optional`
|
||||
|
||||
- `questions`:
|
||||
- `p0_open`: integer
|
||||
- `p1_open`: integer
|
||||
- `p2_open`: integer
|
||||
|
||||
- `metrics`:
|
||||
- `evidence_count`: integer
|
||||
- `mermaid_count`: integer
|
||||
- `table_count`: integer
|
||||
|
||||
- `assumptions`:
|
||||
- List of strings
|
||||
|
||||
## Notes
|
||||
- Phase progression requires DoR/DoD checks and gate approvals.
|
||||
- `state` becomes `awaiting_answers` when P0 questions remain.
|
||||
Reference in New Issue
Block a user