ag-cortex 0.1.0 → 0.1.1
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/.agent/rules/00-constitution.md +7 -4
- package/.agent/rules/90-general-best-practices.md +27 -0
- package/.agent/workflows/work.md +2 -2
- package/lib/core.js +12 -1
- package/package.json +2 -2
- package/.agent/rules/project-rules.md +0 -49
- /package/.agent/{commands → workflows}/test-browser.md +0 -0
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
---
|
|
2
|
+
trigger: always_on
|
|
3
|
+
---
|
|
4
|
+
|
|
1
5
|
# Antigravity Codex
|
|
2
6
|
|
|
3
7
|
This is the central "brain" for Antigravity-powered agents. It defines the core primitives—Skills, Workflows, and Rules—and how they should be used to maintain a high standard of engineering.
|
|
@@ -13,13 +17,12 @@ This is the central "brain" for Antigravity-powered agents. It defines the core
|
|
|
13
17
|
## Repository Structure
|
|
14
18
|
|
|
15
19
|
```
|
|
16
|
-
|
|
20
|
+
[Project Root]/
|
|
17
21
|
├── .agent/
|
|
18
22
|
│ ├── rules/ # Context & Identity (e.g., specific engineering personas)
|
|
19
23
|
│ ├── skills/ # Capabilities (formerly plugins)
|
|
20
|
-
│
|
|
21
|
-
|
|
22
|
-
└── README.md
|
|
24
|
+
│ └── workflows/ # Step-by-step procedures (formerly plans/workflows)
|
|
25
|
+
└── ...
|
|
23
26
|
```
|
|
24
27
|
|
|
25
28
|
## Philosophy: Compounding Engineering
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# General Engineering Standards
|
|
2
|
+
|
|
3
|
+
These are the baseline operating procedures for this project. They are designed to keep velocity high and technical debt low.
|
|
4
|
+
|
|
5
|
+
## 1. Documentation
|
|
6
|
+
Code is read more often than it is written.
|
|
7
|
+
- **Update Docs with Code**: Never ship a feature without updating the relevant documentation (README, API docs, or inline comments).
|
|
8
|
+
- **Why > What**: Comments should explain *why* a complex decision was made, not just *what* the code does.
|
|
9
|
+
|
|
10
|
+
## 2. Testing
|
|
11
|
+
Unverified code is broken code.
|
|
12
|
+
- **Verification First**: Before marking a task as "Done", verify it.
|
|
13
|
+
- **Reproducible**: If you fix a bug, try to add a test case or a reproduction script to prevent regression.
|
|
14
|
+
|
|
15
|
+
## 3. Commit Conventions
|
|
16
|
+
Keep history clean and searchable.
|
|
17
|
+
- `feat: ...` for new features
|
|
18
|
+
- `fix: ...` for bug fixes
|
|
19
|
+
- `refactor: ...` for code structure changes
|
|
20
|
+
- `docs: ...` for documentation updates
|
|
21
|
+
- `chore: ...` for maintenance tasks
|
|
22
|
+
|
|
23
|
+
## 4. Workflows
|
|
24
|
+
Leverage the agents to scale your output.
|
|
25
|
+
- Use `/plan` before starting complex features.
|
|
26
|
+
- Use `/review` to catch issues early.
|
|
27
|
+
- Use `/compound` to save knowledge for the next developer.
|
package/.agent/workflows/work.md
CHANGED
|
@@ -82,7 +82,7 @@ This command takes a work document (plan, specification, or todo file) and execu
|
|
|
82
82
|
- The plan should reference similar code - read those files first
|
|
83
83
|
- Match naming conventions exactly
|
|
84
84
|
- Reuse existing components where possible
|
|
85
|
-
- Follow project coding standards (see
|
|
85
|
+
- Follow project coding standards (see .agent/rules/)
|
|
86
86
|
- When in doubt, grep for similar implementations
|
|
87
87
|
|
|
88
88
|
3. **Test Continuously**
|
|
@@ -117,7 +117,7 @@ This command takes a work document (plan, specification, or todo file) and execu
|
|
|
117
117
|
# Run full test suite
|
|
118
118
|
bin/rails test
|
|
119
119
|
|
|
120
|
-
# Run linting (per
|
|
120
|
+
# Run linting (per .agent/rules/)
|
|
121
121
|
# Use linting-agent before pushing to origin
|
|
122
122
|
```
|
|
123
123
|
|
package/lib/core.js
CHANGED
|
@@ -62,7 +62,18 @@ async function install() {
|
|
|
62
62
|
const destPath = path.join(TARGET_AGENT_DIR, file);
|
|
63
63
|
|
|
64
64
|
await fs.ensureDir(path.dirname(destPath));
|
|
65
|
-
|
|
65
|
+
|
|
66
|
+
// Force removal of existing symlinks to replace with real files
|
|
67
|
+
try {
|
|
68
|
+
const destStat = await fs.lstat(destPath);
|
|
69
|
+
if (destStat.isSymbolicLink()) {
|
|
70
|
+
await fs.remove(destPath);
|
|
71
|
+
}
|
|
72
|
+
} catch (e) {
|
|
73
|
+
// Ignore ENOENT
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
await fs.copy(srcPath, destPath, { overwrite: true, dereference: true });
|
|
66
77
|
}
|
|
67
78
|
console.log(chalk.green(` ✅ Installed ${sourceFiles.length} files.`));
|
|
68
79
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ag-cortex",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Antigravity Cortex - Agentic Workflow Distribution. The central brain and standard library for Antigravity-powered agents.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"ag-cortex": "./bin/ag-cortex.js"
|
|
@@ -28,4 +28,4 @@
|
|
|
28
28
|
"commander": "^11.0.0",
|
|
29
29
|
"fs-extra": "^11.0.0"
|
|
30
30
|
}
|
|
31
|
-
}
|
|
31
|
+
}
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
# Cortex Lab Project Rules
|
|
2
|
-
|
|
3
|
-
This file documents the project's rules, conventions, and workflows. It was migrated from `CLAUDE.md`.
|
|
4
|
-
|
|
5
|
-
## Commands
|
|
6
|
-
|
|
7
|
-
- **`/release-docs`**: Run the release-docs command to update all documentation pages.
|
|
8
|
-
- **`/review`**: Run the review command to perform exhaustive code reviews.
|
|
9
|
-
- **`/test-browser`**: Run browser tests using Playwright.
|
|
10
|
-
- **`/xcode-test`**: Run iOS tests using Xcode simulator.
|
|
11
|
-
|
|
12
|
-
## Project Structure
|
|
13
|
-
|
|
14
|
-
```
|
|
15
|
-
cortex/
|
|
16
|
-
├── .agent/
|
|
17
|
-
│ ├── rules/ # Project rules and conventions
|
|
18
|
-
│ ├── skills/ # Specialized agent skills
|
|
19
|
-
│ └── workflows/ # Automated workflows
|
|
20
|
-
├── docs/ # Documentation site (HTML/CSS)
|
|
21
|
-
├── plugins/ # Plugin source code
|
|
22
|
-
└── ...
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Documentation
|
|
26
|
-
|
|
27
|
-
The documentation site is at `/docs` in the repository root.
|
|
28
|
-
|
|
29
|
-
### Keeping Docs Up-to-Date
|
|
30
|
-
|
|
31
|
-
After ANY change to agents, commands, skills, or MCP servers, update documentation.
|
|
32
|
-
|
|
33
|
-
## Commit Conventions
|
|
34
|
-
|
|
35
|
-
Follow these patterns for commit messages:
|
|
36
|
-
|
|
37
|
-
- `Add [agent/command name]` - Adding new functionality
|
|
38
|
-
- `Remove [agent/command name]` - Removing functionality
|
|
39
|
-
- `Update [file] to [what changed]` - Updating existing files
|
|
40
|
-
- `Fix [issue]` - Bug fixes
|
|
41
|
-
- `Simplify [component] to [improvement]` - Refactoring
|
|
42
|
-
|
|
43
|
-
## Key Learnings
|
|
44
|
-
|
|
45
|
-
### 2024-11-22: Added gemini-imagegen skill and fixed component counts
|
|
46
|
-
Always count actual files before updating descriptions.
|
|
47
|
-
|
|
48
|
-
### 2024-10-09: Simplified marketplace.json to match official spec
|
|
49
|
-
Stick to the official spec. Custom fields may confuse users.
|
|
File without changes
|