create-evda 0.1.0 → 0.1.1

package/README.md

@@ -20,6 +20,7 @@ Writes:
 
     my-evda/
       evda.json              schema version, layers, and the MAPPING of roles to paths
+      README.md              what this is and how it works, for the owner, not the agent
       AGENTS.md              the operating layer. One installer-owned fence; the rest is the owner's
       CLAUDE.md              one line: @AGENTS.md (Claude Code does not read AGENTS.md on its own)
       record/daily/          YYYY-MM-DD.md, verbatim. Day one holds one file: today's, recording

package/create-evda.mjs

@@ -97,6 +97,7 @@ export function scaffold(opts) {
   if (problems.length) throw new EvdaError(`REFUSED: ${problems.join(" ")}`, { exit: 2 });
   const manifest = { evda: SCHEMA_VERSION, id, name: opts.name, owner: { name: opts.owner, kind }, created: today, layers: opts.layers, mapping };
   writeIfAbsent(join(dir, "evda.json"), JSON.stringify(manifest, null, 2) + "\n");
+  writeIfAbsent(join(dir, "README.md"), render("README.md", {}));
   writeIfAbsent(join(dir, mapping.agents), render("AGENTS.md", {}));
   writeIfAbsent(join(dir, "CLAUDE.md"), render("CLAUDE.md", { agents: mapping.agents }));
   if (mapping.ledger) writeIfAbsent(join(dir, mapping.ledger, "hypotheses.md"), render("hypotheses.md", { date: today, name: opts.name }));
@@ -165,6 +166,7 @@ export async function main(argv) {
     return report.exit;
   }
   log(`\nOpen this directory in Claude Code, or any agent that reads AGENTS.md, and it will know what to do.`);
+  log(`It works from your words, takes a position instead of a menu, and parks what cannot be settled yet; it never scores you. Every correction becomes a rule, in your words, in a file you can open and edit. Pushing back is how you use it: it proposes a claim specific enough to be wrong, you say what is wrong, and the next one is sharper. README.md says this again at your own pace.`);
   log(`First move: say something true about today. It goes into record/daily/${localDate()}.md in your words, and nothing is proposed about you until there is something there to be wrong about.`);
   log(`The files are the record. \`evda doctor\` checks them and \`evda reindex\` rebuilds .evda/; neither is required.`);
   return 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-evda",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Make your own EVÐA: a directory that knows what it is. Plain files are the truth, the tooling is optional, and there are no runtime dependencies.",
   "type": "module",
   "bin": {

package/templates/README.md

@@ -0,0 +1,18 @@
+# What this is
+
+This is a notetaking system. You tell it about your life, your problems, your situations, and you
+discuss them here, in `record/`. It evolves. You evolve with it.
+
+**How it responds.** It works from your record, in your words, and it says what it read before it
+answers. It takes a position instead of handing you a menu, and it parks what cannot be settled yet
+instead of forcing an answer. It never scores you, and when something you say bears on something
+parked, it tells you.
+
+**How it improves.** Every correction you make becomes a rule, written in your own words, kept in a
+file you can open and edit yourself. Nothing about it changes except through something you said.
+
+**How you improve with it.** It proposes a claim about you specific enough to be wrong. You say
+exactly what is wrong. The next claim is sharper. Pushing back is not a detour, it is how you use
+this.
+
+`AGENTS.md` is the instructions the agent reads. This file is for you.