@frontfactory/brigade 1.1.0 → 1.1.1

package/README.md

@@ -49,8 +49,8 @@ an answer does) or to leave everything as it is. Without a terminal, it updates.
 
 An existing file is never overwritten. If it differs from the kit, a `.proposed` file is written next to it; if it is
 identical, nothing happens. A file Brigade wrote and nobody touched is updated. `.gitignore` and `.gitattributes` only
-get the lines they miss. `.claude/context/decisions.md` is written once and then belongs to the team: it is never
-updated nor proposed over.
+get the lines they miss. `.claude/context/decisions.md` and `.claude/context/architecture.md` are written once and then belong to the
+project: they are never updated nor proposed over.
 
 ## Update
 
@@ -63,7 +63,8 @@ the answers the older version does not know. To change your options on purpose,
 and choose "Change my options".
 
 Brigade records what it did in `.claude/brigade.json`: its version, your answers and the sha256 of each file it wrote.
-That is how it tells an untouched file from an edited one. Do not edit it by hand.
+That is how it tells an untouched file from an edited one. Do not edit it by hand. Commit it with the rest of `.claude/`:
+the install is shared by the whole team, and anyone can then update it from any machine.
 
 ## Troubleshooting
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@frontfactory/brigade",
-    "version": "1.1.0",
+    "version": "1.1.1",
     "description": "Sets up a Claude Code architecture in any web project: a main session, a Sonnet implementer, a Haiku git-operator and a git guard.",
     "type": "module",
     "scripts": {

package/src/cli.js

@@ -69,7 +69,7 @@ function print(result, interactive) {
 
     if (!interactive) {
         const news = added ? `\n\nNew options, default used: ${added}` : '';
-        console.log(`Brigade installed (stack: ${result.stack}).\n\n${files}\n\n${settings}${news}`);
+        console.log(`Brigade installed (stack: ${result.stack}).\n\n${files}\n\n${settings}${news}\n\nCommit .claude/ including .claude/brigade.json so the install is shared with your team and can be updated from any machine.`);
         return;
     }
 
@@ -78,7 +78,7 @@ function print(result, interactive) {
     if (added) prompter.info(`New options set up: ${added}`);
     if (kept) prompter.warn('Some files of yours differ from the kit: they were kept. Merge the .proposed version if you want it.');
     if (!repo) prompter.warn('Remember to run `git init` before your first commit.');
-    prompter.outro('Done. Run `claude` here, use Plan Mode (Shift+Tab) to discuss, and /brigade-language and /brigade-effort for your own settings.');
+    prompter.outro('Done. Commit `.claude/` with `.claude/brigade.json` to share the install with your team: anyone can then update it from any machine. Run `claude` here, use Plan Mode (Shift+Tab) to discuss, and /brigade-language and /brigade-effort for your own settings.');
 }
 
 const isHelp = (arg) => arg === '--help' || arg === '-h';

package/src/init.js

@@ -1,5 +1,5 @@
 import { isGitRepo } from './detect.js';
-import { appendMissingLines, installFiles, readManifest, writeLocalSettings, writeManifest } from './install.js';
+import { appendMissingLines, hasKitFiles, installFiles, MANIFEST, readManifest, writeLocalSettings, writeManifest } from './install.js';
 import { askOptions } from './options.js';
 import { createPrompter } from './prompt.js';
 import { DEFAULT_STACK, STACKS, detectStack } from './stacks.js';
@@ -50,6 +50,9 @@ export async function runInit({ cwd, yes = false, stack, stackDir, version = VER
     if (!repo) {
         prompter.warn('No git repository here. Brigade will not create one: run `git init` when you are ready. The branch names below are kept for then.');
     }
+    if (!previous && hasKitFiles({ cwd, stackDir: dir })) {
+        prompter.warn(`${MANIFEST} is missing but Brigade files already exist here. Nothing is overwritten: files identical to the kit are adopted and files that differ get a .proposed. If the manifest exists in your team's repo, restore it from git first.`);
+    }
     // A version change replays the kit with the stored answers and only asks the missing options. Otherwise (first
     // install, same version) every question is asked.
     const update = choice === 'update' && installed !== version;

package/src/install.js

@@ -11,10 +11,10 @@ const APPENDS = {
 };
 
 // Written once, then the team's own: never updated, never proposed over.
-const WRITE_ONCE = new Set(['.claude/context/decisions.md']);
+const WRITE_ONCE = new Set(['.claude/context/decisions.md', '.claude/context/architecture.md']);
 
 // Line endings do not count: a CRLF checkout of a kit file is the same file.
-const sha = (content) => createHash('sha256').update(content.replace(/\r\n/g, '\n')).digest('hex');
+export const sha = (content) => createHash('sha256').update(content.replace(/\r\n/g, '\n')).digest('hex');
 
 function listFiles(dir) {
     return readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
@@ -24,6 +24,11 @@ function listFiles(dir) {
     });
 }
 
+// True when the project already holds at least one file of the kit.
+export function hasKitFiles({ cwd, stackDir }) {
+    return listFiles(stackDir).some((source) => existsSync(join(cwd, relative(stackDir, source))));
+}
+
 export function render(content, answers) {
     const values = {
         DEFAULT_BRANCH: answers.defaultBranch,