Help Command

# Help Command

## Command: `help`

Show an overview of this Context repository and what the user can do.

### Steps

1. **Show current directory structure**
   
   Run:
   ```bash
   .context/scripts/print_dir_structure.sh
   ```

2. **Load the glossary**
   
   Read `/GLOSSARY.md` to understand domain-specific terms.

3. **Present the overview**
   
   Display the information below, adapting based on what exists in the repo.

4. **Offer next steps**
   
   - If empty (no `/projects/` or `/people/` folders): suggest `setup`
   - If populated: suggest `ingest` or ask questions

---

## Context Knowledgebase

A structured repository for tracking projects, people, and progress.

### Commands

| Command | Description |
|---------|-------------|
| `setup` | Initialize folder structure, add people/projects, configure glossary |
| `ingest` | Transform free text (meeting notes, Slack, emails) into structured knowledge |
| `ask` | Run a predefined question from `/questions/` (e.g., `ask team-overview`) |
| `report` | Run a predefined report from `/reports/` (e.g., `report weekly-summary`) |
| `help` | Show this overview |

### Structure

```
/projects/:name/README.md                 # Project overview
/projects/:name/work/:item.md             # Task details  
/projects/:name/progress/:year/:month.md  # Monthly updates
/people/:team/:person.md                  # Person profiles
/questions/:name.md                       # Predefined questions
/reports/:name.md                         # Predefined reports
/GLOSSARY.md                              # Domain terms
```

### What You Can Track

**Projects:** Progress updates · Work items · Ideas and proposals

**People:** Current focus · Wins and achievements · Ideas · Interests · Team and role

### Examples

**Ask:** "What is Sarah working on?" · "Show progress on API Gateway" · "Who's interested in Rust?"

**Do:** "Record that Marcus shipped auth" · "Create project Dashboard Redesign" · "Move Sarah to Platform team"

---

### Ingestion

The `ingest` command transforms unstructured text into knowledge:

- **Meeting notes** → Progress entries with dates and attribution
- **Slack threads** → Updates to relevant projects and people
- **Status updates** → Wins, current focus, and interests

Just paste your content and run `ingest` — it extracts names, projects, dates, and achievements automatically.

### Utility Scripts

| Script | Purpose |
|--------|---------|
| `print_datetime.sh` | Get current date/time for entries |
| `print_dir_structure.sh` | Show folder structure |
| `random_project.sh` | Pick a random project to review |
| `random_person.sh` | Pick a random person to review |

### Tips

- **README.md files** — Every folder has one for navigation
- **Cross-linking** — Projects and people reference each other
- **Attribution** — Include `@username` when recording who did what
- **Dates** — All entries include dates for tracking

### Guidelines

- Keep output scannable with tables and bullets
- Show actual directory structure from script output
- Be concise but comprehensive
- Tailor suggestions based on what exists in the repo