add_project_section
Add and position new sections in project main.md files for clear and organized documentation. Ideal for introducing topics, expanding guidelines, or creating structured content groups with flexible placement options.
Instructions
Add a new section to the project main.md file with precise positioning control.
When to use this tool:
- Introducing new topics or guidelines to project
- Expanding project documentation systematically
- Adding configuration sections
- Creating new instruction categories
- Organizing content into new logical groups
Key features:
- Flexible positioning (before/after/end)
- Maintains document structure and flow
- Non-destructive addition
- Reference-based positioning for precision
You should:
- Choose meaningful section headers with "## " prefix
- Decide optimal position for the new section
- Use reference_header for precise placement
- Keep sections focused on single topics
- Follow existing section naming conventions
- Consider document flow and readability
- Add sections progressively, not all at once
DO NOT use when:
- Section already exists (use update_project_section)
- Content belongs in existing section
- Unsure about section organization
Position options: "before", "after", "end" (default) Returns: {success: bool, message?: str, error?: str}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The content for the new section | |
| position | No | Where to insert the section (default: "end") | |
| project_id | Yes | The project identifier | |
| reference_header | No | The section header to use as reference point for before/after positioning | |
| section_header | Yes | The new section header (e.g., "## Configuration") |