tfks/fjx

Better agent bootstrap #2

New issue

Closed

opened 2026-05-14 07:07:40 +00:00 by erik · 4 comments

erik commented

2026-05-14 07:07:40 +00:00

Owner

Right now, I am manually bootstrapping agents which involves things like:

Make sure in correct directory. Is that even necessary now that using git worktrees? Maybe we need to just ensure they bootstrapped from a $HOME directory.
A better story around using git worktrees. Example, cd ../worktrees is not robust.
Provide FJX_{CACHE,USERNAME,PASSWORD} in their environment.
Formalize better how an agent gets bootstrapped (eg claude --agent dev "/dev")

The goal isn't to have them fully autonomous yet but to have me launching them consistently to a) vet the approach for issues, and b) avoid context problems.

Treat this as an investigative task.

Right now, I am manually bootstrapping agents which involves things like: - Make sure in correct directory. Is that even necessary now that using git worktrees? Maybe we need to just ensure they bootstrapped from a $HOME directory. - A better story around using git worktrees. Example, `cd ../worktrees` is not robust. - Provide FJX_{CACHE,USERNAME,PASSWORD} in their environment. - Formalize better how an agent gets bootstrapped (eg `claude --agent dev "/dev"`) The goal isn't to have them fully autonomous yet but to have me launching them consistently to a) vet the approach for issues, and b) avoid context problems. Treat this as an investigative task.

erik added the

labels

2026-05-14 07:07:40 +00:00

agent-pm was assigned by erik

2026-05-14 07:07:40 +00:00

agent-pm added

and removed

labels

2026-05-14 07:42:42 +00:00

agent-pm commented

2026-05-14 07:42:44 +00:00

Member

Brief — Developer

Phase: simple. Read wiki/workflow/prompts/dev-simple.md for the cycle protocol.

# Brief — Developer **Phase:** simple. Read `wiki/workflow/prompts/dev-simple.md` for the cycle protocol.

agent-pm commented

2026-05-14 07:42:45 +00:00

Member

Ledger for: agent-pm

Status: closed @ 2026-05-14T08:06:01.852Z
Briefs:

dev
test
build: absent

Activity

i2/closed : applied

## Ledger for: agent-pm Status: closed @ 2026-05-14T08:06:01.852Z Briefs: - [dev](#issuecomment-788) - [test](#issuecomment-851) - build: absent ### Activity 1. i2/closed : applied

agent-dev added

and removed

labels

2026-05-14 07:52:41 +00:00

agent-pm was unassigned by agent-dev

2026-05-14 07:52:43 +00:00

agent-dev self-assigned this

2026-05-14 07:52:43 +00:00

agent-dev commented

2026-05-14 07:52:44 +00:00

Member

Ledger for: agent-dev

Status: review @ 2026-05-14T08:20:00Z

Tasks

Investigate current agent bootstrap implementation
Understand directory and environment setup requirements
Document findings on git worktree usage
Create findings document with recommendations
Transition to agent/review via PR #3

Evidence

Investigation Complete:

Analyzed current bootstrap flow: agent runs /dev → fjx dev prompt bootstrap → orchestrates workflow
Identified directory assumption gaps: bootstrap uses ../worktrees/<project>-<N> relative paths
Confirmed manual env var setup required: FJX_CACHE, FJX_TOKEN/FJX_USERNAME/FJX_PASSWORD
Found no unified bootstrap command with env configuration

Findings Document Created:

Path: wiki/findings/2-better-agent-bootstrap.md
Documents veracity (confirmed), root cause, impact, and proposed fixes
Provides 4 implementation tasks for future work

PR:

Created PR #3 "Findings: Better agent bootstrap"
Branch: chore/better-agent-bootstrap
Includes findings document in wiki
References issue #2

Checkpoint: 2026-05-14T08:20:00Z

## Ledger for: agent-dev Status: review @ 2026-05-14T08:20:00Z ### Tasks - [x] Investigate current agent bootstrap implementation - [x] Understand directory and environment setup requirements - [x] Document findings on git worktree usage - [x] Create findings document with recommendations - [x] Transition to agent/review via PR #3 ### Evidence **Investigation Complete:** - Analyzed current bootstrap flow: agent runs `/dev` → `fjx dev prompt bootstrap` → orchestrates workflow - Identified directory assumption gaps: bootstrap uses `../worktrees/<project>-<N>` relative paths - Confirmed manual env var setup required: `FJX_CACHE`, `FJX_TOKEN`/`FJX_USERNAME`/`FJX_PASSWORD` - Found no unified bootstrap command with env configuration **Findings Document Created:** - Path: `wiki/findings/2-better-agent-bootstrap.md` - Documents veracity (confirmed), root cause, impact, and proposed fixes - Provides 4 implementation tasks for future work **PR:** - Created PR #3 "Findings: Better agent bootstrap" - Branch: `chore/better-agent-bootstrap` - Includes findings document in wiki - References issue #2 ### Checkpoint: 2026-05-14T08:20:00Z

erik referenced this issue from a commit

2026-05-14 07:54:49 +00:00

docs: findings on agent bootstrap improvements (#2)

agent-dev referenced this issue from a pull request that will close it,

2026-05-14 07:54:58 +00:00

Findings: Better agent bootstrap #3

agent-dev added

and removed

labels

2026-05-14 07:55:02 +00:00

agent-dev removed their assignment

2026-05-14 07:55:04 +00:00

agent-pm was assigned by agent-dev

2026-05-14 07:55:04 +00:00

agent-pm added

and removed

labels

2026-05-14 08:06:08 +00:00

agent-pm commented

2026-05-14 08:06:10 +00:00

Member

Brief — Tester

Phase: review. Read wiki/workflow/prompts/test.md for the cycle protocol.

# Brief — Tester **Phase:** review. Read `wiki/workflow/prompts/test.md` for the cycle protocol.

erik closed this issue

2026-05-14 08:23:55 +00:00

Sign in to join this conversation.

No labels

No milestone

No project

No assignees

3 participants

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

tfks/fjx#2

No description provided.