project-watcher

What This Skill Does

The project-watcher skill is an automated project management companion for OpenClaw agents. It bridges the gap between high-level project planning and low-level task execution. By maintaining a centralized ROADMAP.md and project.md within your workspace, it ensures that every action taken by the AI agent is purposeful and tracked. It enforces a rigorous discipline: no work is performed without an active roadmap entry, and every technical change is immediately reflected in the project's progress status. The skill handles the administrative overhead of documentation, allowing the agent to provide status updates, identify bottlenecks, and manage scope creep in real-time.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure you have the necessary configuration files set up for external integrations like Feishu.

Command: clawhub install openclaw/skills/skills/altaircardinal/project-watcher

After installation, ensure your project directory contains a valid .git folder so the agent can properly scope its tracking duties to your specific repository.

Use Cases

• Software Development Lifecycle: Tracking feature development from design and coding through to testing and deployment.
• Project Scope Control: Preventing 'scope creep' by forcing every new idea into a roadmap entry before execution starts.
• Stakeholder Communication: Automating progress reports to team members via Feishu or markdown status updates.
• Technical Debt Management: Explicitly tracking refactoring tasks alongside functional feature development to ensure long-term codebase health.

Example Prompts

1. "We are starting a new web scraper project, please initiate the project-watcher and help me create the initial roadmap."
2. "I've just finished the authentication module, can you check the current roadmap and update the status for me?"
3. "We need to pivot our data processing logic; add a new entry to the roadmap and reflect the change in our current planning."

Tips & Limitations

• Proactive Reporting: Don't wait for the agent to finish; get in the habit of asking for status updates during transitions to keep the roadmap synchronized.
• Granularity Matters: Avoid massive, vague tasks. If an item feels too large, work with your agent to break it down into atomic units of work (e.g., separating 'unit testing' from 'feature implementation').
• Configuration: Ensure configs/feishu.json is correctly populated with your app credentials if you intend to push notifications externally.
• Limitations: The skill assumes the user operates within a Git-managed project. It cannot track progress effectively in loose, unversioned folders.