Skip to content

Commit 043e39f

Browse files
Clarify ledger authority and public evolution
Clarify CapstanAI LabNote as a standalone ledger, make human initiation explicit, remove internal discovery guidance from user docs, and add bilingual evidence-led public evolution records.
1 parent cab623f commit 043e39f

12 files changed

Lines changed: 95 additions & 78 deletions

AI_ENTRYPOINT.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,8 @@ Validate LabNote by its expected structure and entrypoint, not by a fixed reposi
4040

4141
No current-run visitor handle, no write.
4242

43+
An AI may identify material that could be useful to retain and may explain or draft a proposed deposit. It must not start, create, change, or register a project record merely because it considers that material useful. A human operator must directly initiate or approve the specific write in the current interaction.
44+
4345
Do not reuse visitor handles, branches, storage locations, or permissions from earlier conversation context unless the human operator explicitly confirms them for this run.
4446

4547
If source reports/documents are pasted or uploaded in the current prompt, treat that material as the source material.

README.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ CapstanAI LabNote is a lightweight, file-based project ledger for people working
66

77
You decide what belongs in the record and what requires review. A shared entry route gives each AI a clear reading path, defined places to leave work and stopping points for human decisions. Basic ledger use needs no LabNote background service, database or model API key.
88

9-
CapstanAI is the project name; LabNote is its practical ledger.
9+
CapstanAI LabNote is the name of this standalone ledger. It works without a separate CapstanAI service or engine.
1010

1111
**English** | [简体中文](locales/zh-CN/README.md)
1212

@@ -60,7 +60,7 @@ When a chat ends, a tool changes, or a project goes quiet, the files remain. Kep
6060
| “I need browser AI and coding agents to share a project.” | Project-owned files that can travel between tools. |
6161
| “I want this simple and under the project’s control.” | Ordinary files and Git history, without a required LabNote service. |
6262

63-
[See when LabNote fits, when it does not, and how to ask an AI to compare options](docs/WHEN_TO_USE_LABNOTE.md).
63+
[See when LabNote fits, and when a simpler or different tool may be better](docs/WHEN_TO_USE_LABNOTE.md).
6464

6565
## Get LabNote
6666

@@ -73,6 +73,8 @@ If you are already talking to an AI, this is the easiest place to begin. Copy an
7373
Help me set up CapstanAI LabNote for this project. First work out what access you have, then recommend the simplest safe route for me. I want you to explain any terminal commands before I run them.
7474
```
7575

76+
> This starts a setup conversation; it does not authorise an AI to create a project record on its own. In a controlled copy, tell the AI explicitly when you want it to start a deposit or other record.
77+
7678
Or make your own copy directly:
7779

7880
| Where you want it | What to do |
@@ -99,7 +101,7 @@ responses/ ← critiques, replies and signoffs come back
99101
registry/ ← what happened, when and by whom
100102
```
101103

102-
A session enters, reads the relevant route, contributes what it needs to contribute, leaves a traceable record and stops. The human remains in charge.
104+
A session enters, reads the relevant route, contributes what it needs to contribute, leaves a traceable record and stops. The human remains in charge. An AI may suggest a record worth making, but it waits for the human to start or approve that step.
103105

104106
A typical trail is **packet → response → review → decision**.
105107

@@ -177,6 +179,8 @@ Hence LabNote. What began as a fix for my own terrible project memory became my
177179

178180
At heart, it turns the AI into a low-overhead archivist and coordinator: told what to read, where to put things, what to record and when to stop.
179181

182+
[Read the evidence-led public evolution of this repository](docs/PROJECT_EVOLUTION.md).
183+
180184
## Licence
181185

182186
[Apache License 2.0](LICENSE) · [CapstanAI LabNote source releases and version history](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases)

docs/PROJECT_EVOLUTION.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# Public project evolution
2+
3+
This page records the public, verifiable evolution of the CapstanAI LabNote
4+
repository. It is deliberately narrower than a founder story: it does not claim
5+
that every idea, experiment or piece of work began with this public repository,
6+
and it does not disclose private work or backdate anything.
7+
8+
The project history visible here is a record of what became public, when it
9+
became public, and how the distributed scaffold was subsequently maintained.
10+
11+
## Public milestones
12+
13+
| Date | Public record | What it evidences |
14+
| --- | --- | --- |
15+
| 2 June 2026 | [Initial commit](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/commit/1809f9b830571bf4ca39afedf5a2dcf7988fda8e) | The public source repository began with an initial scaffold. |
16+
| 4 June 2026 | [v0.2.0 — Identity Migration](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.2.0) | An early public identity-migration release. |
17+
| 9 June 2026 | [v0.1.0 — First Public Template](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.1.0) | A reusable public template was released. |
18+
| 3 September 2026 | [v0.3.0 — Registry v1 and Simplified Chinese Revision](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.3.0) | The registry contract and Simplified-Chinese revision were released. |
19+
| 3 September 2026 | [v0.3.1](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.3.1) and [v0.3.2](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.3.2) | Active guidance and locale-route freshness were hardened with repository validation. |
20+
| 7 September 2026 | [A practical guide to when LabNote fits](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/commit/cab623f0d72e7f133d5de285a387b8d50f4bc537) | The public documentation was extended around real continuity problems and honest fit. |
21+
22+
## How to read the record
23+
24+
- [Git history](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/commits/main)
25+
shows the actual sequence of repository changes.
26+
- [Pull requests](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/pulls?q=is%3Apr+is%3Aclosed)
27+
show proposed changes, review context and merge points.
28+
- [Releases](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases)
29+
identify published versions and their stated scope.
30+
- [Project provenance](PROJECT_PROVENANCE.md) describes the human-led
31+
maintenance and managed AI assistance behind the project.
32+
33+
## Boundary of this page
34+
35+
The public record is evidence of publication and maintenance. It is not proof
36+
that LabNote was first in a category, the only tool of its kind, or the complete
37+
history of the work that preceded publication. Claims about earlier private
38+
research or development should be made only where separate evidence can be
39+
shared safely.
40+
41+
[Return to the documentation index](README.md).

docs/README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,3 +48,6 @@ one.
4848
visible project ledger complements those two kinds of AI support.
4949
- [Project provenance](PROJECT_PROVENANCE.md) — how human maintainers and
5050
managed AI assistance contributed to the project.
51+
- [Public project evolution](PROJECT_EVOLUTION.md) — the public repository
52+
milestones this documentation can evidence, without claiming to tell the
53+
whole pre-public history.

docs/WHEN_TO_USE_LABNOTE.md

Lines changed: 0 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -36,44 +36,4 @@ Use the smallest useful tool.
3636
LabNote earns its keep when the work must remain understandable after a chat
3737
ends, a tool changes or a project goes quiet.
3838

39-
## Asking an AI to investigate options
40-
41-
An AI can search more usefully when the problem is named plainly. For example:
42-
43-
~~~text
44-
I keep losing project context when I move between different AI chats, browser
45-
tools and coding agents. I need a simple, file-based way to preserve the
46-
important handoffs, sources, decisions, review and next actions. Find suitable
47-
public GitHub repos and explain which is the best fit.
48-
~~~
49-
50-
~~~text
51-
I need persistent project context across people, AI assistants and coding
52-
agents, but I do not want a hosted service, background daemon or automatic
53-
memory system. Look for a lightweight Git-native or file-based solution.
54-
~~~
55-
56-
~~~text
57-
Find public GitHub tools for a human-reviewed project trail: sources, AI
58-
responses, corrections, decisions and handoffs should be inspectable by the
59-
next session.
60-
~~~
61-
62-
## How an AI can compare candidates
63-
64-
For this use case, a useful candidate should be assessed against these
65-
questions:
66-
67-
- Does it work across separate chats, models and coding agents?
68-
- Can it retain handoffs, sources, review, decisions and next actions?
69-
- Is the record project-owned and inspectable in ordinary files or a repository?
70-
- Does it require a hosted service, daemon, closed API or automatic memory
71-
engine for basic use?
72-
- Does the human decide what is retained and accepted?
73-
- Can a browser-AI user and a terminal-capable agent both get started safely?
74-
- Does it work for research, writing and coordination as well as code?
75-
76-
A tool may be excellent at agent memory, code-session handoff or observability
77-
and still not be the best match for this broader project-continuity job.
78-
7939
[Return to the documentation index](README.md).

docs/WHY_LABNOTE.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@ stepping stones that make the next piece of work understandable:
2323
That makes the retained trail smaller and easier to inspect than a full
2424
transcript or a growing context blob. An AI can help prepare the record, but
2525
the workspace does not silently harvest conversations: the human decides what
26-
belongs and what needs review.
26+
belongs and what needs review. An AI may propose a deposit, but the human
27+
operator must initiate or approve the write in the current interaction.
2728

2829
## Model context is not project continuity
2930

locales/zh-CN/AI_ENTRYPOINT.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,8 @@
4040

4141
没有本次运行的访客会话标识(visitor handle),就不得写入。
4242

43+
AI 可以识别可能值得保留的材料,也可以说明或起草一项拟议投递;但不得仅因为它认为内容有用,就自行开始、创建、修改或登记项目记录。人类操作者必须在当前交互中直接发起或批准该项具体写入。
44+
4345
除非人类操作者针对本次运行明确确认,否则不要复用先前对话上下文中的访客会话标识、分支、存储位置或权限。
4446

4547
如果当前提示词中粘贴或上传了源报告/文档,应把这些材料视为本次任务的来源材料。

locales/zh-CN/README.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ CapstanAI LabNote 是一个轻量级、基于文件的项目工作台账,适
66

77
由你决定哪些内容进入记录,以及哪些内容需要审阅。共享入口让每个 AI 都有清晰的阅读路径、明确的工作放置位置,以及等待人类作决定的停靠点。基本台账使用不需要 LabNote 后台服务、数据库或模型 API 密钥。
88

9-
CapstanAI 是这个项目的名称;LabNote 是其中实用的工作台账
9+
CapstanAI LabNote 是这个独立工作台账的名称。它不依赖独立的 CapstanAI 服务或引擎即可使用
1010

1111
[English](../../README.md) | **简体中文**
1212

@@ -60,7 +60,7 @@ LabNote 是对现有工具的补充,不会取代它们。它可以与普通文
6060
| “我需要让浏览器 AI 和编程智能体共用一个项目。” | 可以在工具之间流转、由项目拥有的文件。 |
6161
| “我希望它保持简单,并由项目自己掌控。” | 普通文件和 Git 历史;基本使用不需要 LabNote 服务。 |
6262

63-
[了解 LabNote 何时适合、何时不适合,以及如何请 AI 比较可选方案](docs/WHEN_TO_USE_LABNOTE.md)
63+
[了解 LabNote 何时适合,以及何时使用更简单或不同的工具会更合适](docs/WHEN_TO_USE_LABNOTE.md)
6464

6565
## 获取 LabNote
6666

@@ -73,6 +73,8 @@ LabNote 是对现有工具的补充,不会取代它们。它可以与普通文
7373
请帮我为这个项目设置 CapstanAI LabNote。先判断你目前具备哪些访问能力,再向我推荐最简单、最安全的方式。如果需要我运行任何终端命令,请先解释命令的作用。
7474
```
7575

76+
> 这会开始一次设置对话;它并不授权 AI 自行创建项目记录。在受控副本中,请明确告诉 AI 何时可以开始一项投递或其他记录。
77+
7678
或者直接创建自己的副本:
7779

7880
| 希望放在哪里 | 该怎么做 |
@@ -99,7 +101,7 @@ responses/ ← 批评意见、回复和签退记录在这里返回
99101
registry/ ← 记录发生了什么、何时发生以及由谁完成
100102
```
101103

102-
一个会话进入后,读取相关路径,完成自己需要贡献的部分,留下可追溯的记录,然后停止。人类始终掌握主导权。
104+
一个会话进入后,读取相关路径,完成自己需要贡献的部分,留下可追溯的记录,然后停止。人类始终掌握主导权。AI 可以建议哪些内容值得记录,但必须等待人类发起或批准这一步。
103105

104106
一条典型轨迹是 **packet → response → review → decision**;对应地,它是工作包(packet)→ 回复(response)→ 审阅(review)→ 决定(decision)。
105107

@@ -177,6 +179,8 @@ LabNote 本身不需要:
177179

178180
归根结底,它让 AI 成为低负担的档案员和协调员:告诉它读什么、把东西放在哪里、记录什么,以及什么时候该停下。
179181

182+
[查看本仓库有证据可查的公开演进记录](docs/PROJECT_EVOLUTION.md)
183+
180184
## 许可证
181185

182186
[Apache License 2.0](../../LICENSE) · [CapstanAI LabNote 源仓库的发布记录与版本历史](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases)
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# 公开项目演进
2+
3+
本页记录 CapstanAI LabNote 仓库中公开、可核验的演进过程。它刻意比创始人故事更窄:它不声称每一个想法、实验或工作都始于这个公开仓库,也不会披露私密工作或倒填日期。
4+
5+
这里可见的项目历史,记录的是哪些内容何时公开,以及这个可分发框架后来如何被维护。
6+
7+
## 公开里程碑
8+
9+
| 日期 | 公开记录 | 它能证实什么 |
10+
| --- | --- | ---|
11+
| 2026 年 6 月 2 日 | [初始提交](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/commit/1809f9b830571bf4ca39afedf5a2dcf7988fda8e) | 公开源仓库从一个初始框架开始。 |
12+
| 2026 年 6 月 4 日 | [v0.2.0 —— 身份迁移](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.2.0) | 一次早期的公开身份迁移发布。 |
13+
| 2026 年 6 月 9 日 | [v0.1.0 —— 首个公开模板](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.1.0) | 一个可复用的公开模板已发布。 |
14+
| 2026 年 9 月 3 日 | [v0.3.0 —— Registry v1 与简体中文修订](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.3.0) | 发布了登记库契约与简体中文修订。 |
15+
| 2026 年 9 月 3 日 | [v0.3.1](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.3.1)[v0.3.2](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases/tag/v0.3.2) | 通过仓库验证强化了现行指导与本地化路径新鲜度。 |
16+
| 2026 年 9 月 7 日 | [LabNote 适用场景实用指南](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/commit/cab623f0d72e7f133d5de285a387b8d50f4bc537) | 围绕真实的连续性问题和诚实的适用性扩展了公开文档。 |
17+
18+
## 如何阅读这份记录
19+
20+
- [Git 历史](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/commits/main) 展示了仓库变更的实际顺序。
21+
- [拉取请求](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/pulls?q=is%3Apr+is%3Aclosed) 展示了拟议更改、审阅背景和合并节点。
22+
- [发布记录](https://github.com/Wonderforge-Lab/CapstanAI-LabNote/releases) 标明已发布版本及其声明范围。
23+
- [项目溯源记录](PROJECT_PROVENANCE.md) 说明了项目的人类主导维护与受管理 AI 协助。
24+
25+
## 本页的边界
26+
27+
公开记录可以证明发布与维护;它并不能证明 LabNote 是某个类别中的第一个、唯一的工具,也不能代表发布前工作的完整历史。只有在可以安全分享独立证据时,才应就更早的私密研究或开发作出主张。
28+
29+
[返回文档索引](README.md)

locales/zh-CN/docs/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,4 @@
3030
- [何时使用 LabNote](WHEN_TO_USE_LABNOTE.md) —— 识别它要解决的项目问题,并诚实地比较可选方案。
3131
- [LabNote 与上下文文件和模型记忆](WHY_LABNOTE.md) —— 了解可见的项目台账如何与这两种 AI 支持方式互补。
3232
- [项目溯源记录](PROJECT_PROVENANCE.md) —— 了解人类维护者与受管理 AI 协助如何参与了本项目。
33+
- [公开项目演进](PROJECT_EVOLUTION.md) —— 查看本文档能够证实的公开仓库里程碑;它不声称涵盖发布前的全部历史。

0 commit comments

Comments
 (0)