geloforge 0.0.0-stage → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +140 -2
- package/THIRD_PARTY_NOTICES.md +33 -0
- package/VERSION +1 -0
- package/core/adopt-project.mjs +458 -0
- package/core/checkpoint.mjs +438 -0
- package/core/codebase-map.mjs +886 -0
- package/core/compatibility.json +16 -0
- package/core/compatibility.mjs +123 -0
- package/core/context-compiler.mjs +1315 -0
- package/core/evidence-capture.mjs +326 -0
- package/core/git-utils.mjs +167 -0
- package/core/handoff.mjs +815 -0
- package/core/json-schema-lite.mjs +119 -0
- package/core/mcp-init.mjs +248 -0
- package/core/mcp-server.mjs +915 -0
- package/core/path-safety.mjs +508 -0
- package/core/project-locator.mjs +231 -0
- package/core/project-lock.mjs +438 -0
- package/core/project-status.mjs +609 -0
- package/core/project-validator.mjs +544 -0
- package/core/skills-history.mjs +572 -0
- package/core/skills-lifecycle.mjs +2225 -0
- package/core/skills-lint.mjs +365 -0
- package/core/skills.mjs +1449 -0
- package/core/task-manager.mjs +1042 -0
- package/core/template-utils.mjs +190 -0
- package/core/text-utils.mjs +48 -0
- package/core/verify-task.mjs +48 -0
- package/core/yaml-subset.mjs +572 -0
- package/package.json +47 -4
- package/policies/approval-boundaries.md +42 -0
- package/policies/memory-policy.md +53 -0
- package/policies/token-efficiency.md +30 -0
- package/schemas/README.md +43 -0
- package/schemas/adr.schema.json +64 -0
- package/schemas/agent-handoff.schema.json +139 -0
- package/schemas/approval-record.schema.json +101 -0
- package/schemas/conflict-record.schema.json +60 -0
- package/schemas/context-pack-manifest.schema.json +194 -0
- package/schemas/evidence-manifest.schema.json +83 -0
- package/schemas/incident-record.schema.json +53 -0
- package/schemas/project-manifest.schema.json +90 -0
- package/schemas/project-state.schema.json +64 -0
- package/schemas/recovery-checkpoint.schema.json +49 -0
- package/schemas/research-record.schema.json +76 -0
- package/schemas/task-contract.schema.json +95 -0
- package/scripts/bootstrap-project.mjs +357 -0
- package/scripts/geloforge.mjs +2291 -0
- package/templates/profiles/README.md +19 -0
- package/templates/profiles/ai-system/brain/profile.md +21 -0
- package/templates/profiles/ai-system/gitignore.append +5 -0
- package/templates/profiles/ai-system/profile.json +6 -0
- package/templates/profiles/automation/brain/profile.md +19 -0
- package/templates/profiles/automation/gitignore.append +5 -0
- package/templates/profiles/automation/profile.json +6 -0
- package/templates/profiles/desktop/brain/profile.md +21 -0
- package/templates/profiles/desktop/gitignore.append +7 -0
- package/templates/profiles/desktop/profile.json +6 -0
- package/templates/profiles/mobile/brain/profile.md +20 -0
- package/templates/profiles/mobile/gitignore.append +8 -0
- package/templates/profiles/mobile/profile.json +6 -0
- package/templates/profiles/web/brain/profile.md +21 -0
- package/templates/profiles/web/gitignore.append +6 -0
- package/templates/profiles/web/profile.json +6 -0
- package/templates/project-starter/AGENTS.md +26 -0
- package/templates/project-starter/GEMINI.md +16 -0
- package/templates/project-starter/README.md +26 -0
- package/templates/project-starter/brain/INDEX.md +40 -0
- package/templates/project-starter/brain/architecture/overview.md +30 -0
- package/templates/project-starter/brain/decisions/.gitkeep +0 -0
- package/templates/project-starter/brain/manifest.yaml +36 -0
- package/templates/project-starter/brain/requirements/constraints.md +29 -0
- package/templates/project-starter/brain/requirements/prd.md +37 -0
- package/templates/project-starter/brain/state/current.yaml +19 -0
- package/templates/project-starter/gitignore.template +25 -0
- package/templates/project-starter/src/.gitkeep +0 -0
- package/templates/project-starter/tasks/.gitkeep +0 -0
- package/templates/project-starter/tests/.gitkeep +0 -0
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Project Profiles (Base Template + Small Profile Overrides)
|
|
2
|
+
|
|
3
|
+
Rather than duplicating [project-starter](../project-starter/README.md) for every application domain, `scripts/bootstrap-project.mjs` applies an optional, small **profile overlay** on top of the shared Second Brain template (`--profile <name>`).
|
|
4
|
+
|
|
5
|
+
Every profile keeps the exact same Second Brain schemas, authority model, and `AGENTS.md` / `GEMINI.md` entrypoints, adding only:
|
|
6
|
+
|
|
7
|
+
1. `brain/profile.md` — concise domain conventions, platform considerations, and testing checklist.
|
|
8
|
+
2. `.gitignore` additions from `gitignore.append`.
|
|
9
|
+
3. `profile` and `profile_version` fields in `brain/manifest.yaml` checked by [compatibility.mjs](../../core/compatibility.mjs).
|
|
10
|
+
|
|
11
|
+
## Available Profiles
|
|
12
|
+
|
|
13
|
+
| Profile (`--profile`) | Version | Focus |
|
|
14
|
+
| :--- | :--- | :--- |
|
|
15
|
+
| `web` | `1.0.0` | Browser/web apps, bundle/API hygiene, accessibility, E2E/unit testing |
|
|
16
|
+
| `desktop` | `1.0.0` | Native/cross-platform desktop apps, installer/packaging & OS permission hygiene |
|
|
17
|
+
| `mobile` | `1.0.0` | iOS/Android mobile apps, device signing, offline state & store compliance |
|
|
18
|
+
| `automation` | `1.0.0` | CLI tools, scheduled jobs, idempotency, retries & dry-run safety |
|
|
19
|
+
| `ai-system` | `1.0.0` | LLM/agent/ML pipelines, evaluation harnesses, prompt/cost/safety boundaries |
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Project Profile: AI System (`{{PROFILE_NAME}}` v`{{PROFILE_VERSION}}`)
|
|
2
|
+
|
|
3
|
+
- **Project:** {{PROJECT_NAME}} (`{{PROJECT_ID}}`)
|
|
4
|
+
- **Second Brain Index:** `brain/INDEX.md`
|
|
5
|
+
- **Constraints:** `brain/requirements/constraints.md`
|
|
6
|
+
|
|
7
|
+
## Domain Conventions
|
|
8
|
+
|
|
9
|
+
- Keep prompts, schemas, evaluation datasets, and provider adapter interfaces separated under `src/`.
|
|
10
|
+
- Gate external paid model calls, tool permissions, and irreversible mutations behind explicit budgets and approvals (`APPR-NNNN`).
|
|
11
|
+
- Never treat unverified model outputs (`A6`) as authoritative truth (`A1`–`A3`).
|
|
12
|
+
|
|
13
|
+
## Testing Guidance
|
|
14
|
+
|
|
15
|
+
- Use deterministic fixtures and recorded evaluations in `tests/` without calling metered APIs in standard CI/local checks.
|
|
16
|
+
- Report token efficiency metrics only from measured execution logs.
|
|
17
|
+
|
|
18
|
+
## Documentation Checklist
|
|
19
|
+
|
|
20
|
+
- [ ] Model/provider boundaries, spend caps, and fallback limits recorded in `brain/requirements/constraints.md`.
|
|
21
|
+
- [ ] Evaluation baseline and safety boundaries documented before enabling autonomous workflows.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Project Profile: Automation (`{{PROFILE_NAME}}` v`{{PROFILE_VERSION}}`)
|
|
2
|
+
|
|
3
|
+
- **Project:** {{PROJECT_NAME}} (`{{PROJECT_ID}}`)
|
|
4
|
+
- **Second Brain Index:** `brain/INDEX.md`
|
|
5
|
+
- **Constraints:** `brain/requirements/constraints.md`
|
|
6
|
+
|
|
7
|
+
## Domain Conventions
|
|
8
|
+
|
|
9
|
+
- Design destructive or mutating workflows to be idempotent and support a non-mutating `--dry-run` preview mode.
|
|
10
|
+
- Bound retries explicitly and never fail silently on partial side effects.
|
|
11
|
+
|
|
12
|
+
## Testing Guidance
|
|
13
|
+
|
|
14
|
+
- Verify dry-run, overwrite refusal, invalid input rejection, and partial-failure rollback in temporary directories.
|
|
15
|
+
|
|
16
|
+
## Documentation Checklist
|
|
17
|
+
|
|
18
|
+
- [ ] Idempotency guarantees, retry bounds, and failure recovery steps documented in `brain/architecture/overview.md`.
|
|
19
|
+
- [ ] Required credentials and approval boundaries recorded without embedding secrets.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Project Profile: Desktop (`{{PROFILE_NAME}}` v`{{PROFILE_VERSION}}`)
|
|
2
|
+
|
|
3
|
+
- **Project:** {{PROJECT_NAME}} (`{{PROJECT_ID}}`)
|
|
4
|
+
- **Second Brain Index:** `brain/INDEX.md`
|
|
5
|
+
- **Constraints:** `brain/requirements/constraints.md`
|
|
6
|
+
|
|
7
|
+
## Domain Conventions
|
|
8
|
+
|
|
9
|
+
- Isolate OS-specific filesystem, IPC, and window-lifecycle adapters from core business logic in `src/`.
|
|
10
|
+
- Store user preferences and runtime state in standard per-OS app-data paths rather than modifying installation directories.
|
|
11
|
+
- Treat local filesystem writes, auto-updaters, and native process execution as explicit security boundaries.
|
|
12
|
+
|
|
13
|
+
## Testing Guidance
|
|
14
|
+
|
|
15
|
+
- Test core logic independently of GUI event loops where possible.
|
|
16
|
+
- Verify path handling with spaces, Unicode filenames, and clean startup/shutdown before packaging installers.
|
|
17
|
+
|
|
18
|
+
## Documentation Checklist
|
|
19
|
+
|
|
20
|
+
- [ ] Supported OS versions and CPU architectures listed in `brain/requirements/constraints.md`.
|
|
21
|
+
- [ ] Packaging, code-signing, and permission requirements recorded in `brain/decisions/`.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Project Profile: Mobile (`{{PROFILE_NAME}}` v`{{PROFILE_VERSION}}`)
|
|
2
|
+
|
|
3
|
+
- **Project:** {{PROJECT_NAME}} (`{{PROJECT_ID}}`)
|
|
4
|
+
- **Second Brain Index:** `brain/INDEX.md`
|
|
5
|
+
- **Constraints:** `brain/requirements/constraints.md`
|
|
6
|
+
|
|
7
|
+
## Domain Conventions
|
|
8
|
+
|
|
9
|
+
- Never commit keystores, provisioning profiles, signing certificates, or `google-services.json` secrets.
|
|
10
|
+
- Separate offline persistence, network sync, and UI state cleanly under `src/`.
|
|
11
|
+
|
|
12
|
+
## Testing Guidance
|
|
13
|
+
|
|
14
|
+
- Keep domain logic and offline-cache behavior covered by fast host-side unit tests before emulator/device runs.
|
|
15
|
+
- Document minimum OS SDK targets and required device permissions in `brain/requirements/constraints.md`.
|
|
16
|
+
|
|
17
|
+
## Documentation Checklist
|
|
18
|
+
|
|
19
|
+
- [ ] Minimum Android/iOS API levels and hardware permissions recorded in `brain/requirements/constraints.md`.
|
|
20
|
+
- [ ] Signing & release artifact procedures documented without storing credentials.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Project Profile: Web (`{{PROFILE_NAME}}` v`{{PROFILE_VERSION}}`)
|
|
2
|
+
|
|
3
|
+
- **Project:** {{PROJECT_NAME}} (`{{PROJECT_ID}}`)
|
|
4
|
+
- **Second Brain Index:** `brain/INDEX.md`
|
|
5
|
+
- **Constraints:** `brain/requirements/constraints.md`
|
|
6
|
+
|
|
7
|
+
## Domain Conventions
|
|
8
|
+
|
|
9
|
+
- Separate client-bundle state, server/API contracts, and build outputs cleanly under `src/`.
|
|
10
|
+
- Never expose private API keys or server secrets in client-side bundles or `VITE_*` / `NEXT_PUBLIC_*` variables.
|
|
11
|
+
- Document browser support, CSP/CORS boundaries, and responsive breakpoints in `brain/requirements/constraints.md`.
|
|
12
|
+
|
|
13
|
+
## Testing Guidance
|
|
14
|
+
|
|
15
|
+
- Keep fast unit/component tests deterministic without requiring live external network services.
|
|
16
|
+
- Verify accessibility (keyboard navigation, semantic landmarks, contrast) and production build output before releasing.
|
|
17
|
+
|
|
18
|
+
## Documentation Checklist
|
|
19
|
+
|
|
20
|
+
- [ ] Target runtime & browser compatibility matrix recorded in `brain/requirements/constraints.md`.
|
|
21
|
+
- [ ] API contracts and environment variable template documented without real secrets.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# AGENTS.md — Project Agent Entrypoint
|
|
2
|
+
|
|
3
|
+
> **Configuration Notice:** Creating this file does **not** automatically configure Codex, Google Antigravity, or any autonomous subagent runtime. It is a concise, provider-independent entrypoint to shared project memory.
|
|
4
|
+
|
|
5
|
+
## Start Here (Do Not Duplicate the Second Brain)
|
|
6
|
+
|
|
7
|
+
Read shared project memory in priority order before proposing or implementing changes:
|
|
8
|
+
|
|
9
|
+
1. **Global Harness Policies (`A0`):** Refer to `<harness-root>/policies/approval-boundaries.md`, `memory-policy.md`, and `token-efficiency.md`.
|
|
10
|
+
2. **Project Navigation:** [brain/INDEX.md](./brain/INDEX.md) and [brain/manifest.yaml](./brain/manifest.yaml).
|
|
11
|
+
3. **Current Operational State:** [brain/state/current.yaml](./brain/state/current.yaml) (check `active_tasks`, `blocked_tasks`, `pending_approvals`, and `open_conflicts`).
|
|
12
|
+
4. **Authoritative Requirements (`A1`):** [brain/requirements/prd.md](./brain/requirements/prd.md) and [brain/requirements/constraints.md](./brain/requirements/constraints.md).
|
|
13
|
+
5. **Architecture (`A2`):** [brain/architecture/overview.md](./brain/architecture/overview.md) and accepted records in `brain/decisions/`.
|
|
14
|
+
|
|
15
|
+
## Governance Summary
|
|
16
|
+
|
|
17
|
+
- Never treat draft/template documents or `is_example: true` records as owner-approved authority.
|
|
18
|
+
- Never silently ignore contradicting evidence (`A3`/`A5`); log a `CONF-NNNN` conflict in `brain/conflicts/` or `proposals/`.
|
|
19
|
+
- Owner approval (`APPR-NNNN`) is required for requirement changes, architecture decisions, security boundaries, spend/paid APIs, and destructive or external mutations.
|
|
20
|
+
- Never commit secrets (`.env*`, keys, tokens) to this repository.
|
|
21
|
+
|
|
22
|
+
## Human-in-the-Loop Co-Pilot Protocol
|
|
23
|
+
|
|
24
|
+
- **Recommend, don't assume:** When multiple architectural or product approaches exist, present options + trade-offs and run `geloforge recommend` to check pending human approvals.
|
|
25
|
+
- **Prevent context rot:** Start focused tasks with `geloforge context --task TASK-NNNN --from-diff --map --profile quick`, mark finished tasks `done`, and save state with `geloforge checkpoint create` before switching sessions.
|
|
26
|
+
- **Coordinate across IDEs:** Claim a cooperative lease (`geloforge task claim --task TASK-NNNN --tool <ide> --role <role> --scopes "..."`) before concurrent editing, and release it when finished.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# GEMINI.md — Gemini CLI Project Entrypoint
|
|
2
|
+
|
|
3
|
+
> **Configuration Notice:** Creating this file does **not** automatically configure Gemini CLI, Google Antigravity, or autonomous agent execution. This project shares one canonical Second Brain across all tools.
|
|
4
|
+
|
|
5
|
+
## Shared Project Memory Entrypoint
|
|
6
|
+
|
|
7
|
+
Refer directly to shared project memory rather than duplicating instructions here:
|
|
8
|
+
|
|
9
|
+
- **Agent Entrypoint & Governance Summary:** [AGENTS.md](./AGENTS.md)
|
|
10
|
+
- **Second Brain Index:** [brain/INDEX.md](./brain/INDEX.md)
|
|
11
|
+
- **Project Manifest:** [brain/manifest.yaml](./brain/manifest.yaml)
|
|
12
|
+
- **Current State:** [brain/state/current.yaml](./brain/state/current.yaml)
|
|
13
|
+
- **Requirements & Constraints:** [brain/requirements/prd.md](./brain/requirements/prd.md), [brain/requirements/constraints.md](./brain/requirements/constraints.md)
|
|
14
|
+
- **Architecture:** [brain/architecture/overview.md](./brain/architecture/overview.md)
|
|
15
|
+
|
|
16
|
+
Global harness policies and schemas live in the harness repository (`<harness-root>/`).
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
- **Project ID:** `{{PROJECT_ID}}`
|
|
4
|
+
- **Owner:** {{PROJECT_OWNER}}
|
|
5
|
+
- **Created:** {{CREATED_DATE}}
|
|
6
|
+
- **Harness Template Version:** `{{HARNESS_VERSION}}`
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
{{PROJECT_DESCRIPTION}}
|
|
11
|
+
|
|
12
|
+
## Second Brain Entrypoint
|
|
13
|
+
|
|
14
|
+
All authoritative project knowledge, operational tasks, research, and verification evidence live inside this repository—independent of any AI provider's chat history:
|
|
15
|
+
|
|
16
|
+
- [Second Brain Index](./brain/INDEX.md)
|
|
17
|
+
- [Project Manifest](./brain/manifest.yaml)
|
|
18
|
+
- [Current Project State](./brain/state/current.yaml)
|
|
19
|
+
- [Product Requirements (Draft until approved)](./brain/requirements/prd.md)
|
|
20
|
+
- [Constraints (Draft until approved)](./brain/requirements/constraints.md)
|
|
21
|
+
- [Architecture Overview (Draft until approved)](./brain/architecture/overview.md)
|
|
22
|
+
|
|
23
|
+
## Provider Entrypoints
|
|
24
|
+
|
|
25
|
+
- [AGENTS.md](./AGENTS.md) — Concise entrypoint for agent tooling (does **not** auto-configure Codex or subagents).
|
|
26
|
+
- [GEMINI.md](./GEMINI.md) — Concise entrypoint for Gemini CLI tooling (does **not** auto-configure Gemini CLI or subagents).
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Second Brain Index — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
**Project ID:** `{{PROJECT_ID}}`
|
|
4
|
+
**Owner:** {{PROJECT_OWNER}}
|
|
5
|
+
|
|
6
|
+
This index maps the project's four-layer, provider-independent Second Brain. All project memory lives here in plain Markdown and YAML rather than inside any AI vendor's chat history.
|
|
7
|
+
|
|
8
|
+
## Layer 1 — Authoritative Knowledge (`L1_AUTHORITATIVE`)
|
|
9
|
+
|
|
10
|
+
- [Project Manifest](./manifest.yaml) — Canonical metadata, version compatibility, and path map.
|
|
11
|
+
- [Product Requirements Document](./requirements/prd.md) — Goals, scope, and functional requirements (`A1` once owner-approved).
|
|
12
|
+
- [Project Constraints](./requirements/constraints.md) — Non-functional, technical, budget, and compliance boundaries (`A1` once owner-approved).
|
|
13
|
+
- [Architecture Overview](./architecture/overview.md) — System boundaries and architectural summary (`A2` once approved).
|
|
14
|
+
- [Architecture Decision Records](./decisions/) — Immutable `ADR-NNNN-*.md` history (`A2` when `status: "accepted"`).
|
|
15
|
+
|
|
16
|
+
## Layer 2 — Operational Memory (`L2_OPERATIONAL`)
|
|
17
|
+
|
|
18
|
+
- [Current Project State](./state/current.yaml) — Active tasks, blockers, pending approvals, and open conflicts (`A4`).
|
|
19
|
+
- [Tasks](../tasks/) — Scoped `TASK-NNNN` contracts and `HANDOFF-NNNN` transfers (`A4`; create status subdirectories on demand if helpful).
|
|
20
|
+
|
|
21
|
+
## Layer 3 — Research and Evidence (`L3_RESEARCH_EVIDENCE`) and On-Demand Folders
|
|
22
|
+
|
|
23
|
+
Create these folders only when needed to avoid empty-directory clutter:
|
|
24
|
+
|
|
25
|
+
- `brain/research/` — Verified/proposed `RES-NNNN-*.md` findings (`A5`).
|
|
26
|
+
- `brain/lessons/` — Post-mortem takeaways (`A3`/`A4`).
|
|
27
|
+
- `brain/conflicts/` — `CONF-NNNN-*.yaml` contradiction records (`A4`).
|
|
28
|
+
- `brain/incidents/` — Optional `INC-NNNN-*.yaml` failure/postmortem records.
|
|
29
|
+
- `proposals/` — Staged drafts (`ADR-NNNN`, `RES-NNNN`, `APPR-NNNN`) awaiting owner approval.
|
|
30
|
+
- `evidence/` — Reproducible verification manifests `EVID-NNNN-*.yaml` (`A3`).
|
|
31
|
+
- `docs/` — Project-specific user or developer guides.
|
|
32
|
+
|
|
33
|
+
## Layer 4 — Temporary Context (`L4_TEMPORARY_CONTEXT`)
|
|
34
|
+
|
|
35
|
+
- Compile deterministic, trust-tiered context packs on demand with `geloforge context --task TASK-0001 --map` (supports `quick`, `working`, and `deep` profiles).
|
|
36
|
+
|
|
37
|
+
## Code Directories
|
|
38
|
+
|
|
39
|
+
- [Source](../src/) — Application/library source code.
|
|
40
|
+
- [Tests](../tests/) — Automated tests.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Architecture Overview — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
- **Project ID:** `{{PROJECT_ID}}`
|
|
4
|
+
- **Status:** `DRAFT — NOT YET APPROVED`
|
|
5
|
+
- **Memory Layer:** `L1_AUTHORITATIVE` (once approved)
|
|
6
|
+
- **Authority Level:** `A6` (draft) -> `A2` (after ADR/owner approval)
|
|
7
|
+
- **Owner:** {{PROJECT_OWNER}}
|
|
8
|
+
- **Created:** {{CREATED_DATE}}
|
|
9
|
+
|
|
10
|
+
## 1. High-Level Topology
|
|
11
|
+
|
|
12
|
+
Document major modules, boundaries, data flow, and external dependencies once architectural planning begins.
|
|
13
|
+
|
|
14
|
+
## 2. Key Architectural Decisions
|
|
15
|
+
|
|
16
|
+
Accepted Architecture Decision Records live in [brain/decisions/](../decisions/) (`ADR-NNNN-*.md`).
|
|
17
|
+
|
|
18
|
+
| ADR ID | Title | Status |
|
|
19
|
+
| :--- | :--- | :--- |
|
|
20
|
+
| `(none yet)` | — | — |
|
|
21
|
+
|
|
22
|
+
## 3. Repository Layout
|
|
23
|
+
|
|
24
|
+
- `src/` — Implementation source code
|
|
25
|
+
- `tests/` — Automated tests
|
|
26
|
+
- `docs/` — Optional project documentation (created on demand)
|
|
27
|
+
- `brain/` — Second Brain memory (`L1`–`L3`)
|
|
28
|
+
- `tasks/` — Scoped task contracts and handoffs
|
|
29
|
+
- `proposals/` — Optional pending proposals awaiting review or owner approval
|
|
30
|
+
- `evidence/` — Optional verification evidence manifests (`EVID-NNNN`)
|
|
File without changes
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Project Manifest
|
|
2
|
+
# Template placeholders are substituted by scripts/bootstrap-project.mjs
|
|
3
|
+
schema_version: "1.1"
|
|
4
|
+
template_version: "{{TEMPLATE_VERSION}}"
|
|
5
|
+
profile: null
|
|
6
|
+
profile_version: null
|
|
7
|
+
project_id: "{{PROJECT_ID}}"
|
|
8
|
+
slug: "{{PROJECT_SLUG}}"
|
|
9
|
+
name: "{{PROJECT_NAME}}"
|
|
10
|
+
description: "{{PROJECT_DESCRIPTION}}"
|
|
11
|
+
status: "template"
|
|
12
|
+
owner: "{{PROJECT_OWNER}}"
|
|
13
|
+
memory_layer: "L1_AUTHORITATIVE"
|
|
14
|
+
authority_level: "A1"
|
|
15
|
+
harness_version: "{{HARNESS_VERSION}}"
|
|
16
|
+
created_at: "{{CREATED_AT}}"
|
|
17
|
+
updated_at: "{{CREATED_AT}}"
|
|
18
|
+
repository:
|
|
19
|
+
vcs: "git"
|
|
20
|
+
initialized: false
|
|
21
|
+
default_branch: "main"
|
|
22
|
+
paths:
|
|
23
|
+
brain_index: "brain/INDEX.md"
|
|
24
|
+
prd: "brain/requirements/prd.md"
|
|
25
|
+
constraints: "brain/requirements/constraints.md"
|
|
26
|
+
architecture: "brain/architecture/overview.md"
|
|
27
|
+
state: "brain/state/current.yaml"
|
|
28
|
+
decisions_dir: "brain/decisions"
|
|
29
|
+
research_dir: "brain/research"
|
|
30
|
+
tasks_dir: "tasks"
|
|
31
|
+
evidence_dir: "evidence"
|
|
32
|
+
proposals_dir: "proposals"
|
|
33
|
+
policies:
|
|
34
|
+
- "policies/approval-boundaries.md"
|
|
35
|
+
- "policies/memory-policy.md"
|
|
36
|
+
- "policies/token-efficiency.md"
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Project Constraints — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
- **Project ID:** `{{PROJECT_ID}}`
|
|
4
|
+
- **Status:** `DRAFT — NOT YET OWNER-APPROVED`
|
|
5
|
+
- **Memory Layer:** `L1_AUTHORITATIVE` (once owner-approved)
|
|
6
|
+
- **Authority Level:** `A6` (draft) -> `A1` (after explicit owner approval)
|
|
7
|
+
- **Owner:** {{PROJECT_OWNER}}
|
|
8
|
+
- **Created:** {{CREATED_DATE}}
|
|
9
|
+
|
|
10
|
+
> **Notice:** Global `A0` harness security boundaries always apply regardless of project status. Populate project-specific constraints below and obtain owner approval before treating them as `A1`.
|
|
11
|
+
|
|
12
|
+
## 1. Technical and Runtime Constraints
|
|
13
|
+
|
|
14
|
+
- Target OS / Runtime: ...
|
|
15
|
+
- Allowed languages, frameworks, and dependency constraints: ...
|
|
16
|
+
|
|
17
|
+
## 2. Security, Privacy, and Compliance Constraints
|
|
18
|
+
|
|
19
|
+
- No secrets or credentials committed to repository (`A0`).
|
|
20
|
+
- Project-specific data handling or privacy requirements: ...
|
|
21
|
+
|
|
22
|
+
## 3. Performance, Budget, and Operational Constraints
|
|
23
|
+
|
|
24
|
+
- Latency / size / resource limits: ...
|
|
25
|
+
- Paid API / infrastructure spend rules (zero automatic spend without `APPR-NNNN`): ...
|
|
26
|
+
|
|
27
|
+
## 4. Non-Negotiable Invariants
|
|
28
|
+
|
|
29
|
+
1. ...
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Product Requirements Document (PRD) — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
- **Project ID:** `{{PROJECT_ID}}`
|
|
4
|
+
- **Status:** `DRAFT — NOT YET OWNER-APPROVED`
|
|
5
|
+
- **Memory Layer:** `L1_AUTHORITATIVE` (once owner-approved)
|
|
6
|
+
- **Authority Level:** `A6` (draft) -> `A1` (after explicit owner approval)
|
|
7
|
+
- **Owner:** {{PROJECT_OWNER}}
|
|
8
|
+
- **Created:** {{CREATED_DATE}}
|
|
9
|
+
|
|
10
|
+
> **Notice:** Replace this starter template with concrete requirements and obtain explicit owner approval (`APPR-NNNN`) before treating this document as `A1` authoritative truth.
|
|
11
|
+
|
|
12
|
+
## 1. Problem Statement
|
|
13
|
+
|
|
14
|
+
Describe the core user or engineering problem this project solves.
|
|
15
|
+
|
|
16
|
+
## 2. Goals and Success Metrics
|
|
17
|
+
|
|
18
|
+
- Goal 1: ...
|
|
19
|
+
- Measurable Success Criterion: ...
|
|
20
|
+
|
|
21
|
+
## 3. Scope
|
|
22
|
+
|
|
23
|
+
### In Scope
|
|
24
|
+
- ...
|
|
25
|
+
|
|
26
|
+
### Out of Scope
|
|
27
|
+
- ...
|
|
28
|
+
|
|
29
|
+
## 4. Functional Requirements
|
|
30
|
+
|
|
31
|
+
| ID | Requirement | Priority | Acceptance Criteria |
|
|
32
|
+
| :--- | :--- | :--- | :--- |
|
|
33
|
+
| `REQ-001` | Define first requirement | Must | Testable criterion |
|
|
34
|
+
|
|
35
|
+
## 5. Open Questions
|
|
36
|
+
|
|
37
|
+
- List unresolved product or technical questions here.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Current Operational Project State
|
|
2
|
+
schema_version: "1.1"
|
|
3
|
+
project_id: "{{PROJECT_ID}}"
|
|
4
|
+
state_revision: 0
|
|
5
|
+
status: "initialized"
|
|
6
|
+
memory_layer: "L2_OPERATIONAL"
|
|
7
|
+
authority_level: "A4"
|
|
8
|
+
updated_at: "{{CREATED_AT}}"
|
|
9
|
+
updated_by: "{{PROJECT_OWNER}}"
|
|
10
|
+
current_phase: "initialization"
|
|
11
|
+
active_tasks: []
|
|
12
|
+
blocked_tasks: []
|
|
13
|
+
pending_approvals: []
|
|
14
|
+
open_conflicts: []
|
|
15
|
+
last_verified_evidence: null
|
|
16
|
+
last_checkpoint: null
|
|
17
|
+
last_completed_task: null
|
|
18
|
+
known_dependencies: []
|
|
19
|
+
summary: "Project Second Brain initialized from harness project-starter template; no application tasks executed yet."
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Environment & Secrets (NEVER commit)
|
|
2
|
+
.env
|
|
3
|
+
.env.*
|
|
4
|
+
*.pem
|
|
5
|
+
*.key
|
|
6
|
+
*.p12
|
|
7
|
+
*.pfx
|
|
8
|
+
secrets/
|
|
9
|
+
|
|
10
|
+
# Dependencies & build artifacts
|
|
11
|
+
node_modules/
|
|
12
|
+
dist/
|
|
13
|
+
build/
|
|
14
|
+
coverage/
|
|
15
|
+
|
|
16
|
+
# Machine-local runtime & temp files
|
|
17
|
+
*.log
|
|
18
|
+
tmp/
|
|
19
|
+
*.tmp
|
|
20
|
+
local-runtime/
|
|
21
|
+
|
|
22
|
+
# OS & editor local files
|
|
23
|
+
.DS_Store
|
|
24
|
+
Thumbs.db
|
|
25
|
+
.vscode/*.local
|
|
File without changes
|
|
File without changes
|
|
File without changes
|