Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
4d68600
Merge pull request #441 from citizenweb3/dev
cardinalser Oct 1, 2025
49465f1
Merge pull request #444 from citizenweb3/dev
alibabaedge Oct 8, 2025
eb48e6e
Merge pull request #448 from citizenweb3/dev
alibabaedge Oct 14, 2025
dd0e2ff
Merge pull request #452 from citizenweb3/dev
alibabaedge Oct 17, 2025
b3275a0
Merge pull request #469 from citizenweb3/dev
alibabaedge Oct 31, 2025
5764272
Merge pull request #472 from citizenweb3/dev
alibabaedge Nov 6, 2025
def64a9
Create networks.md
serejandmyself Nov 22, 2025
e1ba55d
Fix typo in header from 'Networks' to 'Network'
serejandmyself Nov 22, 2025
53523e3
Update networks.md
serejandmyself Nov 22, 2025
0c14dd3
Update networks.md
serejandmyself Nov 27, 2025
29faa27
Merge pull request #519 from citizenweb3/dev
alibabaedge Feb 9, 2026
72a94d3
Merge pull request #520 from citizenweb3/updates/dev-update
alibabaedge Feb 10, 2026
8fde7ce
Merge pull request #521 from citizenweb3/dev
alibabaedge Feb 10, 2026
34ed4e1
Merge pull request #523 from citizenweb3/updates/dev-update
alibabaedge Feb 12, 2026
6e62a0c
Merge pull request #524 from citizenweb3/updates/dev-update
alibabaedge Feb 14, 2026
c82ff15
Merge pull request #526 from citizenweb3/dev
alibabaedge Feb 16, 2026
44e440c
Merge pull request #527 from citizenweb3/updates/dev-update
alibabaedge Feb 19, 2026
be04a53
Merge pull request #530 from citizenweb3/updates/dev-update
alibabaedge Feb 20, 2026
164eb2d
Merge pull request #531 from citizenweb3/updates/dev-update
alibabaedge Feb 25, 2026
fa97dca
Merge pull request #533 from citizenweb3/updates/dev-update
alibabaedge Feb 25, 2026
f880eab
Merge pull request #534 from citizenweb3/updates/dev-update
alibabaedge Feb 25, 2026
2267db3
Merge pull request #535 from citizenweb3/updates/dev-update
alibabaedge Feb 26, 2026
5ad61f9
Merge pull request #536 from citizenweb3/updates/dev-update
alibabaedge Mar 1, 2026
37850fa
Update README.md
serejandmyself Mar 5, 2026
566c4d0
Fix formatting issues in README.md
serejandmyself Mar 5, 2026
b918907
Update README.md
serejandmyself Mar 5, 2026
2cfc5a5
Merge pull request #539 from citizenweb3/updates/dev-update
alibabaedge Mar 8, 2026
486d575
update: added fullstack agent
m1amgn Mar 10, 2026
f323fa4
Merge pull request #545 from citizenweb3/workforce
alibabaedge Mar 10, 2026
f7909fd
fix: clear .next cache before each workflow run
Mar 10, 2026
b4767a7
fix: detect bot reviews by content marker, PR target to updates/dev-u…
Mar 10, 2026
a1c5a7a
feat: Add Staking Rewards Simulator page with interactive inputs, pro…
Mar 10, 2026
68be16d
fix: address review feedback (auto-fix iteration 1)
Mar 10, 2026
18fac4d
fix: address review feedback (auto-fix iteration 2)
Mar 10, 2026
0883c2c
fix: address review feedback (auto-fix iteration 3)
Mar 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
423 changes: 423 additions & 0 deletions .claude/agents/fullstack.md

Large diffs are not rendered by default.

54 changes: 54 additions & 0 deletions .claude/skills/brainstorming/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
name: brainstorming
description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
---

# Brainstorming Ideas Into Designs

## Overview

Help turn ideas into fully formed designs and specs through natural collaborative dialogue.

Start by understanding the current project context, then ask questions one at a time to refine the idea. Once you understand what you're building, present the design in small sections (200-300 words), checking after each section whether it looks right so far.

## The Process

**Understanding the idea:**
- Check out the current project state first (files, docs, recent commits)
- Ask questions one at a time to refine the idea
- Prefer multiple choice questions when possible, but open-ended is fine too
- Only one question per message - if a topic needs more exploration, break it into multiple questions
- Focus on understanding: purpose, constraints, success criteria

**Exploring approaches:**
- Propose 2-3 different approaches with trade-offs
- Present options conversationally with your recommendation and reasoning
- Lead with your recommended option and explain why

**Presenting the design:**
- Once you believe you understand what you're building, present the design
- Break it into sections of 200-300 words
- Ask after each section whether it looks right so far
- Cover: architecture, components, data flow, error handling, testing
- Be ready to go back and clarify if something doesn't make sense

## After the Design

**Documentation:**
- Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
- Use elements-of-style:writing-clearly-and-concisely skill if available
- Commit the design document to git

**Implementation (if continuing):**
- Ask: "Ready to set up for implementation?"
- Use superpowers:using-git-worktrees to create isolated workspace
- Use superpowers:writing-plans to create detailed implementation plan

## Key Principles

- **One question at a time** - Don't overwhelm with multiple questions
- **Multiple choice preferred** - Easier to answer than open-ended when possible
- **YAGNI ruthlessly** - Remove unnecessary features from all designs
- **Explore alternatives** - Always propose 2-3 approaches before settling
- **Incremental validation** - Present design in sections, validate each
- **Be flexible** - Go back and clarify when something doesn't make sense
180 changes: 180 additions & 0 deletions .claude/skills/dispatching-parallel-agents/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,180 @@
---
name: dispatching-parallel-agents
description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
---

# Dispatching Parallel Agents

## Overview

When you have multiple unrelated failures (different test files, different subsystems, different bugs), investigating them sequentially wastes time. Each investigation is independent and can happen in parallel.

**Core principle:** Dispatch one agent per independent problem domain. Let them work concurrently.

## When to Use

```dot
digraph when_to_use {
"Multiple failures?" [shape=diamond];
"Are they independent?" [shape=diamond];
"Single agent investigates all" [shape=box];
"One agent per problem domain" [shape=box];
"Can they work in parallel?" [shape=diamond];
"Sequential agents" [shape=box];
"Parallel dispatch" [shape=box];

"Multiple failures?" -> "Are they independent?" [label="yes"];
"Are they independent?" -> "Single agent investigates all" [label="no - related"];
"Are they independent?" -> "Can they work in parallel?" [label="yes"];
"Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
"Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
}
```

**Use when:**
- 3+ test files failing with different root causes
- Multiple subsystems broken independently
- Each problem can be understood without context from others
- No shared state between investigations

**Don't use when:**
- Failures are related (fix one might fix others)
- Need to understand full system state
- Agents would interfere with each other

## The Pattern

### 1. Identify Independent Domains

Group failures by what's broken:
- File A tests: Tool approval flow
- File B tests: Batch completion behavior
- File C tests: Abort functionality

Each domain is independent - fixing tool approval doesn't affect abort tests.

### 2. Create Focused Agent Tasks

Each agent gets:
- **Specific scope:** One test file or subsystem
- **Clear goal:** Make these tests pass
- **Constraints:** Don't change other code
- **Expected output:** Summary of what you found and fixed

### 3. Dispatch in Parallel

```typescript
// In Claude Code / AI environment
Task("Fix agent-tool-abort.test.ts failures")
Task("Fix batch-completion-behavior.test.ts failures")
Task("Fix tool-approval-race-conditions.test.ts failures")
// All three run concurrently
```

### 4. Review and Integrate

When agents return:
- Read each summary
- Verify fixes don't conflict
- Run full test suite
- Integrate all changes

## Agent Prompt Structure

Good agent prompts are:
1. **Focused** - One clear problem domain
2. **Self-contained** - All context needed to understand the problem
3. **Specific about output** - What should the agent return?

```markdown
Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:

1. "should abort tool with partial output capture" - expects 'interrupted at' in message
2. "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
3. "should properly track pendingToolCount" - expects 3 results but gets 0

These are timing/race condition issues. Your task:

1. Read the test file and understand what each test verifies
2. Identify root cause - timing issues or actual bugs?
3. Fix by:
- Replacing arbitrary timeouts with event-based waiting
- Fixing bugs in abort implementation if found
- Adjusting test expectations if testing changed behavior

Do NOT just increase timeouts - find the real issue.

Return: Summary of what you found and what you fixed.
```

## Common Mistakes

**❌ Too broad:** "Fix all the tests" - agent gets lost
**✅ Specific:** "Fix agent-tool-abort.test.ts" - focused scope

**❌ No context:** "Fix the race condition" - agent doesn't know where
**✅ Context:** Paste the error messages and test names

**❌ No constraints:** Agent might refactor everything
**✅ Constraints:** "Do NOT change production code" or "Fix tests only"

**❌ Vague output:** "Fix it" - you don't know what changed
**✅ Specific:** "Return summary of root cause and changes"

## When NOT to Use

**Related failures:** Fixing one might fix others - investigate together first
**Need full context:** Understanding requires seeing entire system
**Exploratory debugging:** You don't know what's broken yet
**Shared state:** Agents would interfere (editing same files, using same resources)

## Real Example from Session

**Scenario:** 6 test failures across 3 files after major refactoring

**Failures:**
- agent-tool-abort.test.ts: 3 failures (timing issues)
- batch-completion-behavior.test.ts: 2 failures (tools not executing)
- tool-approval-race-conditions.test.ts: 1 failure (execution count = 0)

**Decision:** Independent domains - abort logic separate from batch completion separate from race conditions

**Dispatch:**
```
Agent 1 → Fix agent-tool-abort.test.ts
Agent 2 → Fix batch-completion-behavior.test.ts
Agent 3 → Fix tool-approval-race-conditions.test.ts
```

**Results:**
- Agent 1: Replaced timeouts with event-based waiting
- Agent 2: Fixed event structure bug (threadId in wrong place)
- Agent 3: Added wait for async tool execution to complete

**Integration:** All fixes independent, no conflicts, full suite green

**Time saved:** 3 problems solved in parallel vs sequentially

## Key Benefits

1. **Parallelization** - Multiple investigations happen simultaneously
2. **Focus** - Each agent has narrow scope, less context to track
3. **Independence** - Agents don't interfere with each other
4. **Speed** - 3 problems solved in time of 1

## Verification

After agents return:
1. **Review each summary** - Understand what changed
2. **Check for conflicts** - Did agents edit same code?
3. **Run full suite** - Verify all fixes work together
4. **Spot check** - Agents can make systematic errors

## Real-World Impact

From debugging session (2025-10-03):
- 6 failures across 3 files
- 3 agents dispatched in parallel
- All investigations completed concurrently
- All fixes integrated successfully
- Zero conflicts between agent changes
Loading