Skip to content

Commit 1eff0ca

Browse files
deanzakaclaude
deanzaka
and
claude
committed
feat: add scaffolding — README, scripts, CI, docs, templates (#26176)
Add repo infrastructure for the Cortex starter brain: - README with fork-to-activate CTA and full layout - .gitignore, LICENSE (MIT), tsconfig.json - package.json with validate/summary/assemble scripts - scripts/assemble.mjs (builds dist/workspace.json + cortex.tsk) - scripts/validate.mjs, scripts/summary.mjs - .github/workflows/ci.yml (validate + auto-reassemble on merge) - .github/workflows/publish-bundle.yml (attach .tsk to GH Release) - .github/ISSUE_TEMPLATE/fork-feedback.md - examples/ with blank agent/project/automation templates - docs: GENESIS-101, AGENT-GUIDE, PROJECT-GUIDE, AUTOMATION-GUIDE, APP-KIT-SPEC, FORK-AND-CUSTOMIZE, contributing, repository-structure Artifact filenames kept as original IDs to preserve agent knowledge cross-references. Human-readable names will be handled by the export code (taskcade #26196). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 126da55 commit 1eff0ca

23 files changed

Lines changed: 9048 additions & 0 deletions

‎.github/ISSUE_TEMPLATE/fork-feedback.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: Fork Feedback
3+
about: Tell us about your fork — what you changed, what worked, what didn't
4+
title: "[Fork] "
5+
labels: feedback
6+
assignees: ''
7+
---
8+
9+
**Your fork URL** (optional):
10+
11+
12+
**What did you change?**
13+
<!-- Which agents, projects, automations, or app routes did you modify? -->
14+
15+
16+
**What worked well?**
17+
18+
19+
**What was confusing or broken?**
20+
21+
22+
**What would you add to the template?**

‎.github/workflows/ci.yml‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
- master
8+
pull_request:
9+
10+
permissions:
11+
contents: write
12+
13+
jobs:
14+
validate-bundle:
15+
runs-on: ubuntu-latest
16+
17+
steps:
18+
- name: Checkout
19+
uses: actions/checkout@v4
20+
21+
- name: Setup Node.js
22+
uses: actions/setup-node@v4
23+
with:
24+
node-version: '22'
25+
26+
- name: Run CI checks
27+
run: npm run ci
28+
29+
- name: Reassemble bundle
30+
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
31+
run: npm run assemble
32+
33+
- name: Commit updated cortex.tsk
34+
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
35+
run: |
36+
git config user.name "github-actions[bot]"
37+
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
38+
git add cortex.tsk
39+
git diff --staged --quiet && echo "cortex.tsk is up to date" || git commit -m "chore: reassemble cortex.tsk [skip ci]" && git push

‎.github/workflows/publish-bundle.yml‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
name: Publish Bundle
2+
3+
on:
4+
release:
5+
types: [published]
6+
7+
permissions:
8+
contents: write
9+
10+
jobs:
11+
publish:
12+
runs-on: ubuntu-latest
13+
14+
steps:
15+
- name: Checkout
16+
uses: actions/checkout@v4
17+
18+
- name: Setup Node.js
19+
uses: actions/setup-node@v4
20+
with:
21+
node-version: '22'
22+
23+
- name: Validate
24+
run: npm run validate
25+
26+
- name: Assemble bundle
27+
run: npm run assemble
28+
29+
- name: Upload cortex.tsk to release
30+
env:
31+
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
32+
run: gh release upload "${{ github.event.release.tag_name }}" cortex.tsk --clobber

‎.gitignore‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
dist/
2+
node_modules/
3+
.env
4+
*.tgz

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Taskade Inc.
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,169 @@
1+
# Cortex
2+
3+
**The default starter brain for Taskade Genesis.**
4+
5+
Fork this repo. Import into Taskade. Get a fully wired AI workspace in 60 seconds — 5 agents, 10 projects, 6 automations, 1 app — all connected and running.
6+
7+
> Cortex is not a sample app. It is a working brain. You don't learn it. You use it. Then you make it yours.
8+
9+
---
10+
11+
## What's Inside
12+
13+
### Intelligence — 5 Agents
14+
15+
| Agent | Role | Emoji |
16+
|-------|------|-------|
17+
| **Strategist** | Think in tradeoffs, answer in options | ♟ |
18+
| **Editor** | Cut 30%, keep the nerve | ✂ |
19+
| **Researcher** | Find primary sources, cite everything | 🔍 |
20+
| **Critic** | Argue against whatever you just said | ⚖ |
21+
| **Builder** | Spec it, scope it, ship it | 🛠 |
22+
23+
### Memory — 10 Projects
24+
25+
- **Company Context** — who you are, what you sell, how you talk
26+
- **Decision Log** — every major call, reasoning, outcome
27+
- **5 Playbooks** — Hiring, Launch, Pricing, Fundraise, Support
28+
- **2 Libraries** — Mental Models & Frameworks, References
29+
- **Welcome** — onboarding guide to Cortex itself
30+
31+
### Reflexes — 6 Automations
32+
33+
- **Daily Standup** — morning cron that pulls tasks and summarizes blockers
34+
- **Decision Council** — webhook triggers 3 agents to debate and synthesize
35+
- **Weekly Review** — Friday evening scores the week and plans the next
36+
- **Inbox Triage** — classifies incoming messages and routes to the right agent
37+
- **Incident Response** — assembles a team and creates a war room
38+
- **Monday Planning** — reviews goals and seeds the week's priorities
39+
40+
### Interface — 1 Genesis App
41+
42+
A multi-route React SPA with dashboard, council, journal, and library views — all wired to the agents and projects above.
43+
44+
---
45+
46+
## Quick Start
47+
48+
### Option A: Fork and Import (recommended)
49+
50+
1. **Fork** this repo
51+
2. Go to your Taskade workspace
52+
3. **Import** → select `cortex.tsk` (or point at your fork's URL)
53+
4. All 5 agents, 10 projects, 6 automations, and the app appear — wired and running
54+
55+
### Option B: Clone and Customize
56+
57+
```bash
58+
git clone https://github.com/taskade/cortex.git
59+
cd cortex
60+
npm install
61+
```
62+
63+
Edit any JSON file under `agents/`, `projects/`, `automations/`, or `apps/`.
64+
65+
```bash
66+
npm run validate # Check structural integrity
67+
npm run summary # Print artifact counts and IDs
68+
npm run assemble # Build cortex.tsk bundle
69+
```
70+
71+
Then import the generated `cortex.tsk` into Taskade.
72+
73+
---
74+
75+
## Repo Layout
76+
77+
```
78+
cortex/
79+
├── manifest.json Bundle metadata
80+
├── cortex.tsk One-click import bundle (generated)
81+
│
82+
├── agents/ Intelligence layer
83+
│ ├── strategist.json
84+
│ ├── editor.json
85+
│ ├── researcher.json
86+
│ ├── critic.json
87+
│ └── builder.json
88+
│
89+
├── projects/ Memory layer
90+
│ ├── company-context.json
91+
│ ├── decision-log.json
92+
│ ├── playbook-*.json (5 playbooks)
93+
│ ├── library-*.json (2 libraries)
94+
│ └── welcome.json
95+
│
96+
├── automations/ Reflexes layer
97+
│ ├── daily-standup.json
98+
│ ├── decision-council.json
99+
│ ├── weekly-review.json
100+
│ ├── inbox-triage.json
101+
│ ├── incident-response.json
102+
│ └── monday-planning.json
103+
│
104+
├── apps/
105+
│ └── default.json Genesis app (React SPA, must be "default")
106+
│
107+
├── examples/ Blank templates for creating new artifacts
108+
│ ├── agent-template.json
109+
│ ├── project-template.json
110+
│ └── automation-template.json
111+
│
112+
├── docs/ Guides
113+
│ ├── GENESIS-101.md
114+
│ ├── AGENT-GUIDE.md
115+
│ ├── PROJECT-GUIDE.md
116+
│ ├── AUTOMATION-GUIDE.md
117+
│ ├── APP-KIT-SPEC.md
118+
│ └── FORK-AND-CUSTOMIZE.md
119+
│
120+
└── scripts/ Tooling
121+
├── validate.mjs
122+
├── summary.mjs
123+
└── assemble.mjs
124+
```
125+
126+
---
127+
128+
## Customization
129+
130+
Every JSON file is a standalone artifact. Swap any of them:
131+
132+
- **Replace an agent** — copy `examples/agent-template.json` into `agents/`, write your persona prompt, delete the old one
133+
- **Add a project** — copy `examples/project-template.json` into `projects/`, structure your content, save
134+
- **Modify a flow** — edit trigger/action pairs in `automations/*.json`
135+
- **Redesign the app** — edit the FileSystemTree in `apps/cortex.json`
136+
137+
See [docs/FORK-AND-CUSTOMIZE.md](docs/FORK-AND-CUSTOMIZE.md) for a step-by-step guide.
138+
139+
---
140+
141+
## Scripts
142+
143+
| Command | What it does |
144+
|---------|-------------|
145+
| `npm run validate` | Structural integrity checks on all JSON artifacts |
146+
| `npm run summary` | Print artifact counts and IDs |
147+
| `npm run assemble` | Build `dist/workspace.json` + `cortex.tsk` |
148+
| `npm run ci` | Run summary + validate (used in GitHub Actions) |
149+
150+
---
151+
152+
## Documentation
153+
154+
- [GENESIS-101](docs/GENESIS-101.md) — What is Genesis? The 4 DNA layers
155+
- [AGENT-GUIDE](docs/AGENT-GUIDE.md) — How to write a good agent prompt
156+
- [PROJECT-GUIDE](docs/PROJECT-GUIDE.md) — How to structure memory projects
157+
- [AUTOMATION-GUIDE](docs/AUTOMATION-GUIDE.md) — Triggers, actions, piece library
158+
- [APP-KIT-SPEC](docs/APP-KIT-SPEC.md) — FileSystemTree, Parade engine, SSE
159+
- [FORK-AND-CUSTOMIZE](docs/FORK-AND-CUSTOMIZE.md) — Step-by-step customization
160+
161+
---
162+
163+
## License
164+
165+
[MIT](LICENSE)
166+
167+
---
168+
169+
Built by [Taskade](https://taskade.com). Fork it. Make it yours. Ship it.

0 commit comments

Comments
 (0)