How aadams35/pilarprep-aws works
PilarPrep turns customer context into audience-specific briefs, approved handoffs, meeting analysis, and accountable follow-up. The main path runs from the React workspace through the Jobs API and asynchronous worker; the worker branches into brief generation, project state, meeting processing, and AgentCore workflows. The README documents AWS queueing, storage, and malware-scanning services, but their infrastructure definitions are not in the supplied tree. Relationships below use shown imports/calls where available and documented workflow statements otherwise.
Main entry points: ai_worker/handler.py AI worker · jobs_api/handler.py Jobs API · App.tsx PilarPrep workspace · meeting.py Meeting processing
Components 21
Customer workspace
- PilarPrep workspace
frontend/src/App.tsx - Meeting workspace
frontend/src/components/meeting-intelligence.tsx
Async job processing
- Jobs API
backend/jobs_api/handler.py - SQS job queue
- AI worker
backend/ai_worker/handler.py - Job and project state
backend/pipeline/state.py
Briefs and evidence
- Brief generation
backend/bedrock/brief_generator.py - Evidence retrieval
backend/pipeline/evidence.py - Content safety
backend/shared/content_safety.py
Meeting lifecycle
- Meeting processing
backend/pipeline/meeting.py - Meeting contracts
backend/pipeline/meeting_contracts.py - Scan and transcription
Handoffs and catch-up
- AgentCore workflows
backend/agentcore/runtime/service.py - Governed tools
backend/agentcore/tools/handler.py - AgentCore gateway
backend/agentcore/runtime/gateway.py - Handoff promotion
backend/pipeline/handoff_promotion.py - DOCX packets
backend/agentcore/tools/docx.py
Other components
- Sales / Solutions Architect
- DynamoDB / S3
- Amazon Bedrock
- Knowledge Base
Connections 27
- Sales / Solutions Architect → PilarPrep workspace: prepares context
README.md - PilarPrep workspace → Jobs API: submits and polls
frontend/src/App.tsx - Jobs API → SQS job queue: enqueues jobs
README.md - SQS job queue → AI worker: dispatches jobs
README.md - Jobs API → Job and project state: tracks jobs
backend/jobs_api/handler.py - AI worker → Job and project state: updates state
backend/ai_worker/handler.py - AI worker → Brief generation: generates briefs
backend/ai_worker/handler.py - AI worker → Evidence retrieval: retrieves evidence
backend/ai_worker/handler.py - AI worker → Content safety: screens content
backend/ai_worker/handler.py - Brief generation → Amazon Bedrock: invokes models
README.md - Evidence retrieval → Knowledge Base: retrieves sources
README.md - Jobs API → DynamoDB / S3: issues uploads
backend/jobs_api/handler.py - AI worker → DynamoDB / S3: reads and writes
backend/ai_worker/handler.py - PilarPrep workspace → Meeting workspace: presents workflow
- Meeting workspace → Jobs API: uploads and reviews
README.md - Jobs API → Scan and transcription: starts audio processing
README.md - Scan and transcription → SQS job queue: returns service events
README.md - AI worker → Meeting processing: processes meetings
backend/ai_worker/handler.py - Meeting processing → Meeting contracts: validates analysis
backend/pipeline/meeting.py - Meeting processing → Job and project state: reads and updates
backend/pipeline/meeting.py - AI worker → Governed tools: dispatches workflows
backend/ai_worker/handler.py - Governed tools → DOCX packets: renders packets
backend/agentcore/tools/handler.py - AgentCore workflows → Amazon Bedrock: generates responses
backend/agentcore/runtime/service.py - AgentCore workflows → AgentCore gateway: uses gateway
backend/agentcore/runtime/service.py - Governed tools → DynamoDB / S3: reads and writes state
backend/agentcore/tools/handler.py - AI worker → Handoff promotion: promotes handoffs
backend/ai_worker/handler.py - Sales / Solutions Architect → PilarPrep workspace: reviews follow-up
README.md