Loading...
Loading...
Compare original and translation side by side
.walden/constitution.md.walden/lessons.md| Contract impact | Route |
|---|---|
| Preserve or restore intended behavior | Keep the work outside a new spec-authoring cycle, unless explicit user scope or project rules require a spec. Run existing tests and refresh applicable Walden evidence. |
| Introduce or change intended behavior | Enter authoring: requirements for a new feature, or the earliest affected phase of an existing spec. |
| Unclear | Ask a focused question about intended behavior before selecting a lane or creating speculative documents. |
walden verify <feature>--all| Proposed applicability | Review action |
|---|---|
| Current | Retain the required behavior in the selected verification scope. |
| Superseded | Cite the replacing/removing decision and successor; propose retirement, never perform it automatically. |
| Mixed | Identify surviving requirements and their agreed destination before discarding obsolete design/tasks. |
| Unresolved | Ask the specific business/scope question; do not invent conformity. |
.walden/constitution.md.walden/lessons.md| 契约影响 | 处理路径 |
|---|---|
| 保留或恢复预期行为 | 将工作置于新的规格编写周期之外,除非用户明确的范围要求或项目规则需要编写规格说明。运行现有测试并更新适用的 Walden 验证证据。 |
| 引入或变更预期行为 | 进入编写流程:新功能编写需求阶段,或现有规格中最早受影响的阶段。 |
| 不明确 | 在选择路径或创建推测性文档之前,针对预期行为提出一个聚焦的问题。 |
walden verify <feature>--all| 提议的适用性 | 评审动作 |
|---|---|
| 当前有效 | 在选定的验证范围内保留所需行为。 |
| 已被取代 | 引用替换/移除决策及继任规格;提议退役,绝不要自动执行。 |
| 混合状态 | 在丢弃过时的设计/任务之前,确定仍然有效的需求及其约定的归属。 |
| 未解决 | 提出具体的业务/范围问题;不要虚构一致性。 |
command -v waldenversion --json$HOME/.local/bin/waldenGet-Command walden%USERPROFILE%\go\bin\walden.exeuname -s$env:OSMSYSMINGWcommand -v goGet-Command gogogo install github.com/andrearaponi/walden/cmd/walden@v0.10.4$(go env GOPATH)/bin%USERPROFILE%\go\bingogowalden-v0.10.4-windows-<arch>.exewalden.exenpx skills update waldenwalden updatecommand -v waldenversion --json$HOME/.local/bin/waldenGet-Command walden%USERPROFILE%\go\bin\walden.exeuname -s$env:OSMSYSMINGWcommand -v goGet-Command gogogo install github.com/andrearaponi/walden/cmd/walden@v0.10.4$(go env GOPATH)/bin%USERPROFILE%\go\bingogowalden-v0.10.4-windows-<arch>.exewalden.exenpx skills update waldenwalden updatereview approve--allow-pendingreview approve--allow-pendingwalden --help| Command | When to use it |
|---|---|
| Bootstrap an uninitialized repository after choosing the authoring lane. |
| Create the three canonical documents; names normalize to kebab-case. |
| Inspect phase, freshness, blockers, and next action. |
| Validate the current phase; |
| Present a ready document for review, using |
| Seal that phase only after explicit user approval. |
| Repair a changed approved chain before re-reviewing it. |
| Inspect executable work and evidence warnings. |
| Obtain execution context before implementing an authorized task. |
| Run the declared proof and record completion only on success. |
| Complete an explicitly authorized runnable batch; stop on the first failure. |
| Inspect derived evidence and environment differences; executes diagnostic profile probes. |
| Re-prove completed tasks whose evidence is no longer verified. |
| Force every completed task's proof to run, including currently verified tasks. |
| Report without persisting the ledger; add |
| Judge existing evidence and release blockers; never executes proofs or publishes. |
| Inspect legacy bindings/freshness/provenance without proofs or probes; apply executes selected proofs and needs authorization. |
| Record a reusable correction and its prevention rule. Phases include |
| Inspect binary/schema versions. |
--jsonschema_versioncommandokresultwalden --help| 命令 | 使用场景 |
|---|---|
| 选择编写路径后,初始化未初始化的仓库。 |
| 创建三个标准文档;名称会标准化为 kebab-case 格式。 |
| 查看阶段、时效性、阻塞项和下一步操作。 |
| 验证当前阶段; |
| 提交就绪的文档供评审,阶段可选 |
| 仅在用户明确批准后封存该阶段。 |
| 在重新评审之前,修复已变更的已批准链。 |
| 查看可执行工作和证据警告。 |
| 在实现已授权任务之前获取执行上下文。 |
| 运行声明的证明,仅在成功时记录完成。 |
| 完成明确授权的可运行批次;遇到第一个失败即停止。 |
| 查看派生证据和环境差异;执行诊断配置探测。 |
| 重新验证证据已失效的已完成任务。 |
| 强制运行所有已完成任务的证明,包括当前已验证的任务。 |
| 仅报告结果而不持久化台账;添加 |
| 判断现有证据和发布阻塞项;绝不执行证明或发布。 |
| 无需运行证明或探测即可检查旧版绑定/时效性/来源; |
| 记录可复用的纠正措施及其预防规则。阶段包括 |
| 查看二进制文件/模式版本。 |
--jsonschema_versioncommandokresult.walden/specs/<feature>/.walden/specs/<feature>/<!-- assumed: <choice> (source: <file or document>) -->[decision: <question>]<!-- assumed: <choice> --><!-- assumed: <choice> --><!-- assumed: <choice> (source: <file or document>) -->[decision: <question>]<!-- assumed: <choice> --><!-- assumed: <choice> -->R1R1.AC1NFR1C1Acceptance check:| EARS form | Shape |
|---|---|
| Ubiquitous | |
| Event-driven | |
| State-driven | |
| Optional feature | |
| Unwanted behavior | |
| Complex | |
1. `R1.AC1` WHEN a lease expires, the system SHALL release its lock.
- Acceptance check: another holder can acquire a lock after its lease expires.ears_validationears_distributionwalden validate --jsonR1R1.AC1NFR1C1Acceptance check:| EARS 形式 | 格式 |
|---|---|
| 普遍存在型 | |
| 事件驱动型 | |
| 状态驱动型 | |
| 可选功能型 | |
| 非预期行为型 | |
| 复杂型 | |
1. `R1.AC1` WHEN a lease expires, the system SHALL release its lock.
- Acceptance check: another holder can acquire a lock after its lease expires.walden validate --jsonears_validationears_distribution| `R1` | ... || `R1` | ... |- [ ] 1. Implement and test the behavior
- Requirements: `R1.AC1`
- Design: Architecture
- Verification:
- command: ["go", "test", "-v", "-count=1", "-run", "^TestExample$", "./pkg/example"]
expect_output: "--- PASS: TestExample"
covers: ["R1.AC1"]Verification:covers:- [ ] 1. Implement and test the behavior
- Requirements: `R1.AC1`
- Design: Architecture
- Verification:
- command: ["go", "test", "-v", "-count=1", "-run", "^TestExample$", "./pkg/example"]
expect_output: "--- PASS: TestExample"
covers: ["R1.AC1"]Verification:covers:-run-v-count=1go mod tidy -diffgo mod tidytimeout:timeout: 30mcovers:command: ["sh", "-c", "test -d src && test -f src/main.go"]expect_exit: 1expect_outputVerification: go test ./...-run-v-count=1go mod tidy -diffgo mod tidytimeout:timeout: 30mcovers:command: ["sh", "-c", "test -d src && test -f src/main.go"]expect_exit: 1expect_outputVerification: go test ./...task statustask starttask completereconcileverify --checkverifiedstale-specstale-codefailedunattestedunrecordedpendingunattestedpassedtask statustask starttask completereconcileverify --checkverifiedstale-specstale-codefailedunattestedunrecordedpendingunattestedpassed.walden/environment.md- go: ["go", "version"]- node: ["node", "--version"]platformwaldenadopt <feature>evidence status.walden/environment.md- go: ["go", "version"]- node: ["node", "--version"]platformwaldenadopt <feature>evidence statusadoptbackfillre-provecompleteblockedcompletev1alpha2.walden/RETIRED.mdwalden-historyadoptbackfillre-provecompleteblockedcompleteapplyv1alpha2.walden/RETIRED.mdwalden-historyrelease checkverify--allow-pending --reason "..."--strictrelease checkverify--allow-pending --reason "..."--strictwalden lesson logwalden lesson log