Acquia Source × Bluefly: Product Documentation¶

Owner: Agent/Guild Owner | Updated: 2026-08-05 | Status: Discovery in progress (Phase 1: verify upstream surfaces and source_connector integration)

For Decision Makers¶

Question: "What is Bluefly's Acquia Source strategy?"
Answer: Read ACQUIA/01-STRATEGY.md (10 min)

Question: "What is source_connector?"
Answer: Read https://gitlab.com/blueflyio/agent-platform/drupal/private/source_connect/-/blob/main/README.md — Fleet dashboard + Cedar compliance + MCP tools (10 min)

Question: "What are the commercial terms?"
Answer: Read ACQUIA/04-PILOT-PROPOSAL.md (10 min)

For Operators (Phase 1 Discovery)¶

Question: "What's the current focus?"
Answer: Phase 1 Discovery — verify Acquia Source webhook/JSON:API/Canvas surfaces and map to Drupal contrib ownership. Run bd show canonical Bead.2 for active work.

Question: "What depends on Phase 1 completion?"
Answer: Phase 2 (baseline environment setup) and Phase 3 (governance implementation). All blocked until discovery closes with evidence.

For Engineers (Building Components)¶

Question: "What surfaces can I use to integrate with Source?"
Answer: Read ACQUIA/02-TECHNICAL-SPEC.md — Integration Surfaces section (10 min)

Question: "What contrib modules are required?"
Answer: Read ACQUIA/02-TECHNICAL-SPEC.md — Contrib Audit Gate section (5 min)

Question: "What are the prohibited patterns?"
Answer: Read ACQUIA/02-TECHNICAL-SPEC.md — Prohibited Patterns section (5 min)

For Event/Demo Coordinators¶

Question: "What do we demo at Denver/AI Summit?"
Answer: Read ACQUIA/03-DEMO-AND-EVENTS.md (15 min)

Question: "What demo script should I follow?"
Answer: Read ACQUIA/03-DEMO-AND-EVENTS.md — Demo 1 & 2 sections (20 min)

For Research/Reference¶

Question: "What are the API details for Source/Canvas/OAuth?"
Answer: Read ACQUIA/05-RESEARCH-REFERENCE.md (30 min)

Question: "What compliance standards apply?"
Answer: Read ACQUIA/02-TECHNICAL-SPEC.md — Compliance sections + ACQUIA/05-RESEARCH-REFERENCE.md (20 min)

Document Map¶

README.md (this file)
  Navigation guide for all audiences

ACQUIA/
  01-STRATEGY.md
     What Bluefly builds for Source, why, and competitive context.
     → Read first. Foundation for all other docs.

  02-TECHNICAL-SPEC.md
     Integration surfaces, compliance matrix, contrib requirements.
     → Reference for engineers.

  03-DEMO-AND-EVENTS.md
     Demo scripts, event strategy, what to show.
     → Reference for demos/marketing.

  04-PILOT-PROPOSAL.md
     6-week SOW, deliverables, commercial terms.
     → Reference for sales/pilots.

  05-RESEARCH-REFERENCE.md
     API details, citations, compliance findings.
     → Deep research reference. 30+ pages.

  06-MVP-PLAN.md
     MVP plan, falsifiable hypothesis, scope, and source_connector governance recipe.
     → Reference for implementation.

  07-DELIVERY-BEADS.md
     Work-unit tracking map for Acquia Source delivery.
     → Reference for work units.

  proposed/
     Earlier proposals, experiments, risk registers (archive).
     → Reference only; superseded by 06-MVP-PLAN.md.

Timeline¶

When	What	Status
Now (Phase 1)	Verify Acquia Source surfaces + Drupal contrib ownership	Discovery in progress (canonical Bead.1-4)
After Phase 1	Set up test environment + validate components	Blocked (depends on Phase 1 evidence)
After Phase 2	Implement governance + compliance	Blocked (depends on Phase 2 completion)
Post-discovery	6-week pilot SOW	See `04-PILOT-PROPOSAL.md`
Ongoing	Demo strategy	See `03-DEMO-AND-EVENTS.md`

Key Decisions (Pending Discovery Evidence)¶

Decision	Status	Evidence needed
Scope: Governance on Source sites (not fleet control)	PROPOSED	Verify Acquia Source webhook/JSON:API capability
Use contrib-first: Drupal/Canvas/ECA/Cedar	PROPOSED	Verify integration status with Source
Custom PHP ≤100 lines	PROPOSED	Depends on contrib gap analysis
No new modules; use source_connector as base	PROPOSED	Verify source_connector subsumes requirements
Work tracked in Beads	VERIFIED	Using canonical Bead family
Two-phase timeline: Discovery → Baseline → Config	PROPOSED	Depends on Phase 1 findings

How to Contribute¶

Phase 1 Discovery (Current)¶

Claim canonical Bead.2, 5ra.3, 5ra.4 as needed: bd claim canonical Bead.X
Gather evidence: Acquia Source webhook schema, Drupal contrib status, source_connector capability
Verify claims in 01-STRATEGY.md; update classifications (VERIFIED_UPSTREAM, PROPOSED_COMPOSITION, etc.)
Attach evidence to bead: bd update canonical Bead.X --comment "VERIFIED: [finding]"
Close discovery bead with evidence: bd update canonical Bead.X --status closed

Reference¶

Strategy: 01-STRATEGY.md (Bluefly position)
Technical surfaces: 02-TECHNICAL-SPEC.md
Research/evidence: 05-RESEARCH-REFERENCE.md
source_connector module: https://gitlab.com/blueflyio/agent-platform/drupal/private/source_connect

Staying Aligned¶

Weekly sync (Guild Owner + team)¶

Run bd list → review status
Any blocked beads? Unblock or escalate.
Any questions? Resolve via bead comments.

Standards checks¶

Contrib-first: Before writing PHP, check 02-TECHNICAL-SPEC.md — Contrib Audit Gate
No secrets: Before committing, grep for hardcoded credentials
Bead discipline: Every commit references active bead; every close has evidence

Escalation¶

Blocker: Mark bead ● blocked; Guild Owner reviews
Scope creep: Recognize it's P1+ work; create child P1 bead
Architecture question: Comment in bead; get approval before proceeding

Contacts¶

Role	Contact
Product Owner	Product Owner / Guild Owner
Beads Authority	Agent/Guild Owner
Cedar Questions	Agent/Guild Owner
Acquia Questions	Agent/Guild Owner / Customer context
Drupal Questions	Agent/Guild Owner / Drupal team

Status¶

Milestone	Status	Evidence
Strategy locked	✅ Complete	`01-STRATEGY.md` published 2026-04-25
Technical spec ready	✅ Complete	`02-TECHNICAL-SPEC.md` published 2026-04-25
MVP plan created	✅ Complete	`06-MVP-PLAN.md` created 2026-08-05
Beads initialized	✅ Complete	`canonical Bead` parent + 14 child beads created 2026-08-05
Phase 1 ready to start	✅ Ready	`bd ready` shows 4 Phase 1 beads
Demo script updated	⏳ Pending	Will update after MVP proof-of-concept
Pilot SOW finalized	⏳ Pending	Update after MVP success

Last updated: 2026-08-05 by Agent/Guild Owner
Next review: After Phase 1 complete (~ 2026-08-12)