Slack Bot Developer/Teacher for Company Documentation

We're a growing service company looking for an experienced developer to build a Slack bot that answers employee questions about our HR policies, SOPs, and internal documentation. Team members will tag the bot in a channel, ask a question in plain language, and receive a conversational, accurate answer grounded in our documented materials.

**This is a build + teach engagement.** I have no coding background, and a core requirement of this project is that you walk me through your decisions and architecture as you build, so I can understand, maintain, and eventually extend the system myself. If you're a strong developer but don't enjoy explaining your work, this isn't the right fit.

## What You'll Build

A production-ready Slack bot with the following architecture:

- **Slack integration** using Slack's Bolt framework (Python or Node.js — your recommendation welcome)

- **Retrieval-Augmented Generation (RAG)** pipeline: questions are matched against our documentation via semantic search, and relevant context is passed to an LLM for a conversational answer

- **Vector database** (Pinecone, Weaviate, or a comparable option you can justify) storing embeddings of our policies, SOPs, and transcripts

- **OpenAI API** integration for embeddings and chat completions

- **Document ingestion pipeline** that can handle multiple source formats: Word docs, PDFs, spreadsheets, and plain-text transcripts (e.g., exported Loom video transcripts)

- **Source citations** in bot answers, so users can see which policy or document the answer came from

- Deployment to a cloud environment (AWS, Heroku, Railway, or similar) with clear instructions for how it runs and how to restart or update it

## Technical Requirements

You should have demonstrable experience with:

- Slack app development (Bolt framework, event subscriptions, OAuth/permissions setup)

- OpenAI's API (chat completions and embeddings)

- RAG architecture and vector databases (Pinecone, Weaviate, Qdrant, pgvector, or similar)

- Python or Node.js backend development

- Cloud deployment and basic DevOps (environment variables, API key security, uptime)

**In your proposal, please link to or describe at least one similar project you've built** — ideally a Slack bot, a RAG system, or an LLM-powered internal tool.

## Deliverables

1. A working Slack bot deployed to production and connected to our Slack workspace

2. Document ingestion process (with instructions or a simple tool for me to add new documents myself as our documentation grows)

3. Full source code in a repository I own, with clear comments

4. **Written documentation** covering: system architecture, how each component connects, how to add/update documents, how to update API keys, and common troubleshooting steps

5. **Teaching sessions**: recorded screen-share walkthroughs (or live calls) at each major milestone explaining what was built and why — I estimate 3–5 sessions of 30–60 minutes

6. A handoff session at the end where we test the bot together and review maintenance procedures

## Communication & Working Style

- Regular progress updates (at minimum, 2x per week)

- Willingness to explain decisions in plain English, not just technical jargon

- Patience with beginner questions — teaching is part of the paid scope, not a favor

- Fluent written and spoken English

- Availability for scheduled video calls (please note your time zone in your proposal)

## Scope Notes

- Initial document set is modest, but the system should be designed to scale as our documentation library grows significantly

- Future phases may include: automatic transcript ingestion from Loom, additional Slack channels/workflows, and analytics on what questions get asked — mention if you have experience with any of these

- I will provide: Slack workspace admin access, OpenAI API account, and all documentation to be ingested

## How to Apply

In your proposal, please include:

1. A brief description of a similar project you've built (links or screenshots appreciated)

2. Your recommended tech stack for this project and a one-paragraph explanation of why

3. Your approach to the teaching/documentation component

4. Estimated timeline and total cost (fixed price preferred; open to milestone-based payment)

5. Your time zone and general availability

Proposals that are clearly personalized and address the teaching component will be prioritized. Generic copy-paste proposals will be declined.

Back to blog

Common Interview Questions And Answers

1. HOW DO YOU PLAN YOUR DAY?

This is what this question poses: When do you focus and start working seriously? What are the hours you work optimally? Are you a night owl? A morning bird? Remote teams can be made up of people working on different shifts and around the world, so you won't necessarily be stuck in the 9-5 schedule if it's not for you...

2. HOW DO YOU USE THE DIFFERENT COMMUNICATION TOOLS IN DIFFERENT SITUATIONS?

When you're working on a remote team, there's no way to chat in the hallway between meetings or catch up on the latest project during an office carpool. Therefore, virtual communication will be absolutely essential to get your work done...

3. WHAT IS "WORKING REMOTE" REALLY FOR YOU?

Many people want to work remotely because of the flexibility it allows. You can work anywhere and at any time of the day...

4. WHAT DO YOU NEED IN YOUR PHYSICAL WORKSPACE TO SUCCEED IN YOUR WORK?

With this question, companies are looking to see what equipment they may need to provide you with and to verify how aware you are of what remote working could mean for you physically and logistically...

5. HOW DO YOU PROCESS INFORMATION?

Several years ago, I was working in a team to plan a big event. My supervisor made us all work as a team before the big day. One of our activities has been to find out how each of us processes information...

6. HOW DO YOU MANAGE THE CALENDAR AND THE PROGRAM? WHICH APPLICATIONS / SYSTEM DO YOU USE?

Or you may receive even more specific questions, such as: What's on your calendar? Do you plan blocks of time to do certain types of work? Do you have an open calendar that everyone can see?...

7. HOW DO YOU ORGANIZE FILES, LINKS, AND TABS ON YOUR COMPUTER?

Just like your schedule, how you track files and other information is very important. After all, everything is digital!...

8. HOW TO PRIORITIZE WORK?

The day I watched Marie Forleo's film separating the important from the urgent, my life changed. Not all remote jobs start fast, but most of them are...

9. HOW DO YOU PREPARE FOR A MEETING AND PREPARE A MEETING? WHAT DO YOU SEE HAPPENING DURING THE MEETING?

Just as communication is essential when working remotely, so is organization. Because you won't have those opportunities in the elevator or a casual conversation in the lunchroom, you should take advantage of the little time you have in a video or phone conference...

10. HOW DO YOU USE TECHNOLOGY ON A DAILY BASIS, IN YOUR WORK AND FOR YOUR PLEASURE?

This is a great question because it shows your comfort level with technology, which is very important for a remote worker because you will be working with technology over time...