describe-repo

# Describe Repository

This skill adds or updates metadata for the current repository.

## Instructions for Agent

### 1. Identify Repository

- Detect current repository path: `git rev-parse --show-toplevel`
- Extract repository name from path
- Get remote URL: `git remote get-url origin`
- Determine category (work/personal) based on remote URL:
  - Contains "dev.azure.com" or company domain → work
  - Contains "github.com/yoshiwatanabe" → personal

### 2. Collect Metadata

From user's description, extract:
- **Main description**: What the repository contains/does
- **Team information**: If mentioned
- **Approval process**: If mentioned (e.g., "needs Core-Platform approval")
- **Special notes**: Any important context
- **Tags**: From user parameter or inferred from description

Get current machine and OS context:
- Machine: `hostname` (lowercase)
- OS: Windows/WSL/Linux

### 3. Call Python Script

Execute the manage_memory.py script:

```bash
cd /path/to/.prototype-plugin
python scripts/manage_memory.py describe-repo \
  --config-repo /path/to/yoshiwatanabe-configurations \
  --repo-path {repo_path} \
  --description "{description}" \
  --tags "{tags}" \
  --machine {machine} \
  --os {os}
```

### 4. Handle Result

Parse the JSON output:
```json
{
  "success": true,
  "repo_slug": "dynamics-solutions",
  "filepath": "memory/repositories/dynamics-solutions.md"
}
```

Return confirmation to the user:
```
Repository metadata updated!
- Repository: dynamics-solutions
- Description: [user's description]
- Tags: [tags if any]
- Synced to remote: Yes
```

## Example Usage

**User:** "Hey, this repo contains Dynamics solution packages. We need Core-Platform approval for PRs."

**Agent:**
1. Identifies current repository
2. Extracts key information from description
3. Calls manage_memory.py describe-repo
4. Confirms metadata was saved