debugging

Name: Debugging
Author: bearcove

// Debugging conventions for pikru. Use when adding debug traces or investigating issues. Important rule - leave debug traces in place.

Manus에서 실행

$ git log --oneline --stat

stars:29

forks:4

updated:2025년 12월 19일 08:14

SKILL.md

readonly

name	debugging
description	Debugging conventions for pikru. Use when adding debug traces or investigating issues. Important rule - leave debug traces in place.

Debugging

When in doubt, add tracing:

C code: DBG() macro
Rust code: tracing::debug!() (not eprintln!)

IMPORTANT: Leave debug traces in place!

DO NOT remove DBG() calls from C code after debugging
DO NOT remove tracing::debug!() calls from Rust code after debugging
DO NOT run make clean in vendor/pikchr-c (it's disabled anyway)

Rationale

The C implementation is not used in production - debug traces are helpful for future investigations
Rust tracing can be turned on/off at compile time via RUST_LOG environment variable
Having traces in place makes future debugging much faster

related-skills.json

같은 저장소

subtest-isolation.md

from "bearcove/pikru"

Create minimal subtests to isolate and fix complex bugs. Use when a test fails and the issue is buried in complexity.

2025-12-2729

codebase-layout.md

from "bearcove/pikru"

Codebase organization for pikru. Use when you need to find where specific functionality lives.

2025-12-2729

code-annotations.md

from "bearcove/pikru"

Code annotation requirements for pikru. Use when writing or porting Rust functions from C code. All ported functions must have cref comments.

2025-12-1929

git-commands.md

from "bearcove/pikru"

Git command conventions for pikru. Use when running any git commands to avoid blocking on interactive pager.

2025-12-1929

idiomatic-rust.md

from "bearcove/pikru"

Idiomatic Rust patterns for pikru C port. Use when writing or reviewing Rust code ported from C. Don't write C in Rust - the goal is correct behavior, not line-by-line translation.

2025-12-1929

testing.md

from "bearcove/pikru"

Testing conventions for pikru. Use when running tests to avoid timeouts. DO NOT run the full test suite.

2025-12-1929

package.json