Add Getting Started guide for AI curators

[dragon-ai-agent]

Summary

Addresses #44 by creating a comprehensive "Getting Started" guide for curators new to AI-assisted workflows.

What's Included

1. AI Mindset Framework

• AI as junior curators (need clear instructions)
• AI as agents (can plan and execute)
• AI as personal assistants (scribes and helpers)

2. Progressive Learning Path

• Step 1: Foundational reading (Ethan Mollick's guide)
• Step 2: Tool selection with guidance on when to use each
• Step 3: Apply to workflow with links to existing how-tos
• Step 4: Advanced topics (multi-agent systems, knowledge graphs)

3. Tool Coverage

Each tool includes:

• When to use it
• Links to official documentation
• Links to tutorials and courses
• Cross-references to our existing reference docs

Tools covered:

• Claude Code (recommended for most curators)
• GitHub Copilot
• DragonAI
• Goose

4. Practical Aids

• Quick reference decision tree for tool selection
• Common pitfalls to avoid
• Next steps guidance

5. Curated Resources

All resources from the original issue are included:

• Using AI Right Now - foundational
• Claude Code docs and best practices
• DeepLearning.ai courses
• Advanced resources on multi-agent systems and knowledge graphs

Structure

The guide follows a "read this first, then this, then this" progression as requested, making it suitable for linking from OBOOK as a primary entry point for new users.

Navigation

Added as the second item in the main navigation (after Home, before FAQ) for high visibility.

Resolves #44

🤖 Generated with Claude Code

[claude]

Claude finished @dragon-ai-agent's task —— View job

---

Pull Request Review

Overall Assessment ✅

This is a high-quality documentation addition that successfully addresses issue #44. The "Getting Started" guide is comprehensive, well-structured, and follows the project's focus on practical, actionable guidance for AI-assisted curation workflows.

Strengths

📚 Content Quality

• Progressive learning path: The 4-step structure (fundamentals → tool selection → application → advanced topics) is logical and user-friendly
• Practical focus: Aligns perfectly with the project's mission of providing "immediate, actionable integration strategies"
• Comprehensive tool coverage: Includes all major AI tools relevant to curators with clear guidance on when to use each

🎯 Target Audience Alignment

• Curator-focused language: Uses domain-specific terminology appropriately
• GitHub workflow emphasis: Correctly prioritizes GitHub-based tools, matching the project's focus
• Non-technical accessibility: Despite covering technical tools, maintains approachable language

📖 Structure & Navigation

• Logical organization: Clear sections with descriptive headings
• Decision tree: The quick reference tool selection flowchart is particularly valuable
• Appropriate navigation placement: Added as second item after Home, ensuring high visibility

Technical Review

✅ Links and References

All internal cross-references are valid:

• /reference/clients/claude-code.md ✓
• /how-tos/instruct-github-agent.md ✓
• /reference/clients/goose.md ✓
• /tutorials/ontology-editing-with-ai.md ✓

External links are authoritative and relevant:

• Ethan Mollick's guide (oneusefulthing.org)
• Official Anthropic documentation
• DeepLearning.ai courses

✅ MkDocs Configuration

The mkdocs.yml change correctly adds the new page to navigation:

nav:
  - Home: index.md
  - Getting Started: getting-started.md  # ← New addition
  - FAQ: faq.md

Adherence to Project Guidelines

✅ CLAUDE.md Compliance

• Practical focus: ✓ Emphasizes "immediate, actionable" content
• No theoretical discussions: ✓ Focuses on implementation over theory
• Step-by-step guidance: ✓ Provides clear progression path
• Real-world examples: ✓ Includes practical use cases and decision frameworks

✅ Documentation Standards

• Consistent formatting: Proper Markdown structure and heading hierarchy
• Material theme compatibility: Uses standard elements that work with the existing theme
• Audience-appropriate tone: Maintains consistency with existing documentation

Minor Suggestions

🔍 Content Enhancements

1. Line 166-167: Consider updating the broken link pattern:

   # Current
   - Explore topic-specific guides in our [how-tos](how-tos/instruct-github-agent.md) section
   
   # Suggested  
   - Explore topic-specific guides in our [how-tos](how-tos/) section

2. Prerequisites section: Could benefit from a brief mention of basic command-line familiarity for CLI tools

📊 Metrics Considerations

• Performance: Documentation files have minimal performance impact
• Security: No security concerns - pure documentation content
• Accessibility: Good heading structure supports screen readers

Test Coverage

While traditional test coverage isn't applicable to documentation, the guide includes:

• Link validation: All internal references point to existing files
• Content validation: Aligns with existing project structure and guidelines
• User journey validation: Clear path from newcomer to advanced user

Final Recommendation

✅ APPROVE - This PR significantly enhances the project's accessibility for new users while maintaining high content quality and perfect alignment with project goals. The comprehensive nature of the guide addresses the core need expressed in issue #44.

Post-Merge Suggestions

1. Monitor user feedback on the tool selection decision tree
2. Consider adding user success stories as they emerge
3. Update external links periodically to ensure they remain current

[dragon-ai-agent]

This PR implements the Getting Started guide requested in #44.

Key Features

✅ Mindset framework - Explains AI as junior curators, agents, and personal assistants
✅ Progressive learning path - Clear "read this first, then this" structure
✅ Tool selection guidance - When to use Claude Code, Copilot, DragonAI, Goose
✅ All curated resources - Every link from the issue included with context
✅ Decision tree - Quick reference for choosing the right tool
✅ Practical focus - Aligned with repo mission of immediately actionable content

Structure

The guide flows from fundamentals → tool selection → workflow application → advanced topics, making it ideal for linking from OBOOK as an entry point for new users.

Ready for review @cmungall @matentzn

[Copilot]

Pull Request Overview

This PR adds a comprehensive "Getting Started" guide for curators new to AI-assisted workflows, addressing issue #44. The guide provides a progressive learning path from foundational concepts through tool selection to advanced topics, with curated resources and practical examples.

Key changes:

• Introduces a conceptual framework for understanding AI (as junior curators, agents, and personal assistants)
• Provides structured learning progression with tool selection guidance and decision tree
• Links to external resources (Ethan Mollick's guide, Claude Code documentation, DeepLearning.ai courses) and internal how-tos

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
mkdocs.yml	Adds "Getting Started" to navigation as second item after Home
docs/getting-started.md	New comprehensive guide covering AI mindset, learning path, tool selection (Claude Code, GitHub Copilot, DragonAI, Goose), workflow application, and resources

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[matentzn]

Suggested change

	- **Claude Skills:** Our guide on [Claude Skills](reference/claude-skills.md) for creating reusable AI capabilities
	- **Claude Skills:** Our guide on [Claude Skills](reference/claude-skills.md) for creating reusable AI capabilities
	- **Agentic AI:** A great and curator friendly course on [Agentic AI](https://learn.deeplearning.ai/courses/agentic-ai) by Andrew Ng