Seeds

Records that survive the thread.

The skill writes readable files into the repo so ownership, proof, review state, and resume context survive the thread.

The seeded files are the operating surface.

They are intentionally plain text. The point is not a private dashboard; it is a record any future thread or engineer can inspect.

AGENTS.mdseeded by software-factory

The repo-level operating contract.

Shared rules for every agent that enters the project.

# Project Agent Rules

- Preserve user changes. Never revert unknown work.
- Keep one active writer in the main worktree by default.
- Treat external effects as explicit operator actions.
- Record proof commands and residual risk before declaring done.
- Use the factory docs as the routing source of truth.

factory_config.mdseeded by software-factory

Editable factory settings.

Mode, review posture, permissions, stop rules, and verification cadence.

work_mode: balanced
user_involvement: principal_partner
concurrency_policy: single_writer
verification_level: focused_plus_build
reviewer_policy: risk_triggered
default_stop_mode: drain_to_checkpoint
external_effect_policy: explicit_operator

build_ledger.mdseeded by software-factory

The durable project record.

What changed, what passed, who owns the next step, and what remains risky.

## Current State

status: running
active_owner: builder-thread
current_slice: install flow and landing shell
accepted_evidence:
- npm run typecheck
- npm run build
- browser smoke on desktop and mobile
next_action: review generated asset integration

handoff_protocol.mdseeded by software-factory

A reliable handoff shape.

A scoped work package with enough evidence for review or resume.

## Handoff Bundle

objective:
write_scope:
non_goals:
files_changed:
proof_commands:
known_risks:
recommended_next_action:
stop_or_resume_notes:

review_index.mdseeded by software-factory

Review state without transcript archaeology.

A small index of what was reviewed, accepted, deferred, or blocked.

## Review Index

| Slice | Reviewer | Result | Evidence |
| --- | --- | --- | --- |
| landing shell | reviewer-thread | accepted | build, browser smoke |
| install copy | reviewer-thread | accepted | source readback |
| mode graphics | pending | needs visual QA | desktop/mobile screenshots |

AGENTS.md

Operating contract

Rules every entering agent should respect before touching files.

factory_config.md

Factory posture

The editable settings for mode, verification, review, stop rules, and effects.

build_ledger.md

Current state

The durable record of what changed, what passed, and what remains uncertain.

handoff_protocol.md

Transfer shape

The bundle that lets review or resume happen without guessing.

review_index.md

Review memory

A small index of accepted, deferred, blocked, and pending review work.

Each file answers a different recovery question.

When a thread restarts, the project record should answer where the work stands before another edit happens.