A developer’s guide to the ReacherX codebase

Planning works out how to approach a person. Outreach runs the plan, including waits, approvals, and responses to incoming activity.

That's the normal discovery path. A manually added person or a setup preview can enter somewhere else, so check the record's discoverySource field (search post, people search, or conversation reply) before following it backwards.

The other thing you'll see throughout is event recording. Some events feed Analytics and Agent observability. Some become input for the memory system, which can save lessons for later work.

Where does that code live?

The app uses Next.js and React, with Convex for backend functions and data. Here's the map I would keep open while reading:

For example, an agent tool can ask to qualify someone, but the qualification rules shouldn't live inside that tool. Follow the call into the workflow and shared core. That's also where a fix should go if other callers need the same behavior.

Before adding a helper, search for an existing one. The project already has shared time utilities and validators. Read the repository instructions before making changes.

Pick the part you want to understand

• A strange search result: start with discovery, then follow it into qualification.
• A missing or incorrect profile detail: read enrichment.
• A plan or message you didn't expect: read planning and outreach execution.
• An instruction △ Agent seems to remember: follow memory.
• A dashboard number you can't explain: read reporting.

Each guide points to the implementation and gives you something specific to investigate. Keep the workspace ID in view as you trace a record. Check where IDs come from, and follow saved task state and provider results when you're checking whether a message actually sent. A generated draft alone won't tell you that.

You don't need to understand the whole application before making a useful contribution. Run it locally, reproduce one problem, and follow the relevant path. If you get stuck, ask in Discord. I want people to be able to find their way around this project, and questions help me see where the explanation is missing.