Skip to content

docs: README の背景の節を portfolio の Principles に基づいて書き直し、H3 を日本語にする - #69

Merged
yktsnet merged 1 commit into
mainfrom
docs/readme-background
Sep 29, 2026
Merged

yktsnet merged 1 commit into
mainfrom
docs/readme-background

Conversation

@yktsnet

@yktsnet yktsnet commented Sep 29, 2026

Copy link
Copy Markdown
Owner

概要

#67 で書いた From Writing to Checking の節は、根拠の無い体験談(疲れた日は見落とす、など)で組み立てていた。portfolio の Principles「生成より、検証」が、このリポの主張の出どころにあたるので、そこから書き直す。あわせて日本語版の H3 を日本語にする。

変更

  • 背景の節: 見出しを Verification over Generation(portfolio の英語版の見出しと同じ)に改め、次の2段落で構成する
    • 確かめることに時間がかかるようになり、エージェントは静かに間違え、人が注意する約束は形骸化する
    • 環境差・破壊的コマンド・機密はコードと設定で固定して人のマージを最後の関門にし、壊れてはいけないものだけを人が承認する
  • 推測の削除
    • 「止まった理由の調査に人の時間が取られる」を外す
    • Tech Stack の disko と crit の理由を、実際の構成に書いてあることへ差し替える
  • H3: 日本語版を日本語の見出しにし、Repository Map の対応先を合わせる。英語版は英語のまま

検証手順

  • 背景の節の記述が portfolio の Principles(src/components/Principles.astro)の記述と食い違わないこと
  • Repository Map の対応先が、実在する見出しと一致すること

- From Writing to Checking を Verification over Generation に改め、portfolio の「生成より、検証」の主張から書き直す
- 根拠の無い体験談と推測の理由(端末差で人の時間が取られる・disko と crit の選定理由)を、確かな記述に差し替える
- 日本語版の H3 を日本語にし、Repository Map の対応先を合わせる
@yktsnet
yktsnet merged commit 2ddb377 into main Sep 29, 2026
4 checks passed
@yktsnet
yktsnet deleted the docs/readme-background branch September 29, 2026 12:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant