Skip to content

Commit 98c5377

Browse files
Merge pull request #23 from phil-man-git-hub/feature/issue-23-antigravity-setup
feat: setup Antigravity knowledge base
2 parents c67cf10 + 432571b commit 98c5377

File tree

236 files changed

+16679
-4293
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

236 files changed

+16679
-4293
lines changed

.agent/workflows/ag-archive.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
description: Archive old sessions and compress insights to maintain a lean context.
3+
---
4+
1. **Identify Old Sessions**:
5+
- List files in \`.gemini/antigravity/sessions/\`.
6+
- Identify sessions older than 7 days (or whatever threshold seems appropriate).
7+
8+
2. **Compress Context**:
9+
- Read the old session files.
10+
- Extract any key decisions, architectural changes, or unsolved problems that are NOT yet in \`memory/\` or \`insights/\`.
11+
- Update or create files in \`memory/\` or \`insights/\` with this consolidated information.
12+
13+
3. **Archive**:
14+
- Create directory \`.gemini/antigravity/sessions/archive/\` if it doesn't exist.
15+
- Move the processed session files into the archive directory.
16+
17+
4. **Report**:
18+
- Tell the user: "I have archived [N] sessions and updated our long-term memory with [X] new insights."

.agent/workflows/ag-capture-all.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
description: Capture session data to both Antigravity memory and Project AI context.
3+
---
4+
1. **Archive Antigravity Context**:
5+
- Run the \`/ag-archive\` workflow to summarize insights and clean up the session.
6+
7+
2. **Capture Project Context**:
8+
- Run the project's capture script:
9+
\`python bin/capture-session.py\`
10+
11+
3. **Bridge the Gap**:
12+
- (Optional) Append the Antigravity session summary to the file generated by \`capture-session.py\` (if accessible) to enrich the git-based log with reasoning and insights.
13+
14+
4. **Report**:
15+
- Confirm that both "Brains" (Antigravity and Project) are synced and up to date.

.agent/workflows/ag-commit.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
description: Generate a commit message from context, commit changes, and log the commit to the current session file.
3+
---
4+
1. **Analyze Changes**:
5+
- Run \`git status\` and \`git diff --staged\` (or \`git diff\` if nothing staged).
6+
- Review the current session log in \`.gemini/antigravity/sessions/\` to understand the *intent* behind the changes.
7+
8+
2. **Generate Message**:
9+
- Draft a conventional commit message (e.g., \`feat: ...\`, \`fix: ...\`) based on the changes and the session context.
10+
- **Ask User**: "I propose the following commit message. Shall I proceed? [Message]"
11+
12+
3. **Commit**:
13+
- If approved, run \`git commit -m "..."\`.
14+
15+
4. **Log to Session**:
16+
- Append a note to the current session file:
17+
\`\`\`markdown
18+
- **Commit**: [Hash] - [Message]
19+
\`\`\`

.agent/workflows/ag-load-issue.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
description: Load context for a specific GitHub issue using the project's existing scripts.
3+
---
4+
1. **Retrieve Context**:
5+
- Run the project's context retrieval script:
6+
\`python bin/retrieve-context.py --issue <ISSUE_ID> -o .gemini/antigravity/memory/issue-<ISSUE_ID>-context.md\`
7+
8+
2. **Ingest Context**:
9+
- Read the newly created file: \`.gemini/antigravity/memory/issue-<ISSUE_ID>-context.md\`.
10+
11+
3. **Start Session**:
12+
- Run the \`/ag-new\` workflow (or manually create a session file) focused on this issue.
13+
- **Session Goal**: "Address Issue #<ISSUE_ID>"

.agent/workflows/ag-new.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
description: Start a new work session by reviewing context and creating a session log.
3+
---
4+
1. **Review Context**:
5+
- Read `.gemini/antigravity/README.md` to refresh on protocol.
6+
- List files in `.gemini/antigravity/sessions/` and read the most recent one to see where we left off.
7+
- List files in `.gemini/antigravity/to-dos/` to see active tasks.
8+
9+
2. **Create Session Log**:
10+
- Generate a timestamp in the format `YYYY-MM-DD-HH-MM-SS`.
11+
- Create a new file: `.gemini/antigravity/sessions/<TIMESTAMP>-session-start.md`.
12+
- **Content**:
13+
```markdown
14+
# Session Start: <TIMESTAMP>
15+
**Goal**: [Ask user for goal]
16+
**Context**: [Summary of previous session]
17+
```
18+
19+
3. **Notify User**:
20+
- Tell the user you have reviewed the context and are ready to start.

.agent/workflows/ag-pr.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
description: Prepare a Pull Request description based on the session context and recent commits.
3+
---
4+
1. **Gather Context**:
5+
- Read the current session log.
6+
- Run \`git log origin/main..HEAD\` (or appropriate branch comparison) to see commits in this branch.
7+
8+
2. **Draft PR Description**:
9+
- Create a PR description following the project's template (if any).
10+
- **Title**: Concise summary of the feature/fix.
11+
- **Description**: Detailed explanation of *why* and *how*, referencing the insights from the session log.
12+
- **Testing**: List verification steps performed (from the session log).
13+
14+
3. **Present to User**:
15+
- Output the draft markdown for the user to copy-paste into GitHub/GitLab.

.agent/workflows/ag-review.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
description: Review long-term memory and insights to refresh context.
3+
---
4+
1. **List Knowledge Base**:
5+
- List files in `.gemini/antigravity/memory/`.
6+
- List files in `.gemini/antigravity/insights/`.
7+
8+
2. **Read Key Files**:
9+
- Read `.gemini/antigravity/insights/project_summary.md` (if it exists).
10+
- Read the 3 most recent files in `insights/`.
11+
12+
3. **Summarize**:
13+
- Provide a brief summary of the project status and key architectural decisions based on what you read.

.agent/workflows/ag-save.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
description: Save an insight, session summary, or research note to the knowledge base.
3+
---
4+
1. **Identify Content Type**:
5+
- Ask the user (or determine from context) what type of file to create: `insight`, `session`, `research`, or `memory`.
6+
7+
2. **Generate Filename**:
8+
- Get current timestamp: `YYYY-MM-DD-HH-MM-SS`.
9+
- Ask user for a `CATEGORY` (e.g., `auth`, `ui`, `database`) and a `BRIEF_DESCRIPTION`.
10+
- Construct filename: `.gemini/antigravity/<type>s/<TIMESTAMP>-<CATEGORY>-<DESCRIPTION>.md`.
11+
12+
3. **Write Content**:
13+
- Create the file with the content provided by the user or summarized from the chat.
14+
15+
4. **Update Git**:
16+
- Ensure `.gitignore` still excludes `.gemini/` (just a safety check).
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
description: Scaffold the standard directory structure and files for a new GitHub issue.
3+
---
4+
1. **Get Issue Details**:
5+
- Ask user for the **Issue ID** (e.g., 22).
6+
- Ask user for the **Issue Title** (e.g., "Automate desktop app creation").
7+
8+
2. **Create Directory**:
9+
- Create directory: \`docs/idd/issues/issue-<IssueID>-<SanitizedTitle>/\`.
10+
11+
3. **Scaffold Structure**:
12+
- Based on \`docs/idd/issues/github-issue-tree-template.json\`, create the following subdirectories:
13+
- \`step-01-issue-type/\`
14+
- \`step-11-research/\`
15+
- \`step-21-insight/\`
16+
- \`step-31-cognition/\`
17+
- \`step-41-how-to/\`
18+
- \`step-51-to-do/\`
19+
- \`step-61-memory/\`
20+
21+
4. **Create Files**:
22+
- Create empty markdown files in each subdirectory following the pattern: \`issue-<IssueID>-<step-name>.md\`.
23+
- Example: \`step-11-research/issue-<IssueID>-research.md\`.
24+
25+
5. **Populate To-Do**:
26+
- Read \`docs/idd/issues/github-issue-to-do-template.json\`.
27+
- Create \`step-51-to-do/issue-<IssueID>-to-do.md\` and populate it with the phases from the JSON template, converted to a markdown checklist.
28+
29+
6. **Report**:
30+
- Tell the user: "Scaffolded issue #<IssueID> at docs/idd/issues/issue-<IssueID>-...".

.agent/workflows/ag-start-work.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
description: Start working on a new issue: creates branch, loads context, and prepares plan.
3+
---
4+
1. **Create Branch**:
5+
- Ask user for a short description if not provided.
6+
- Run \`git checkout -b feature/issue-<ISSUE_ID>-<DESCRIPTION>\`.
7+
8+
2. **Load Context**:
9+
- Execute the \`/ag-load-issue\` workflow for this issue ID.
10+
11+
3. **Prepare Plan**:
12+
- Create or update \`implementation_plan.md\`.
13+
- **Header**: \`# Issue #<ISSUE_ID>: <DESCRIPTION>\`
14+
- **Content**: Fill in the standard implementation plan template based on the loaded context.
15+
16+
4. **Notify**:
17+
- Tell the user: "Branch created, context loaded, and plan drafted. Ready to review the plan?"

0 commit comments

Comments
 (0)